Tru64 UNIX 


Logical Storage Manager 


Part Number: AA-RH9BB-TE 


August 2000 


Product Version: Tru64 UNIX Version 5.1 or higher 


This guide describes how to configure and manage disk storage using the 
Logical Storage Manager (LSM) software. It includes information on 
LSM concepts and how to plan, set up, monitor, change, and troubleshoot 
an LSM configuration. 


Compaq Computer Corporation 
Houston, Texas 


©2000 Compaq Computer Corporation 


Compaq, the Compaq logo, and TruCluster Registered in the U.S. Patent and Trademark Office Tru64 isa 
trademark of Compaq Information Technologies Group, L.P. 


UNIX and The Open Group are trademarks of The Open Group. All other product names mentioned herein 
may be trademarks of their respective companies. 


Confidential computer software. Valid license from Compaq required for possession, use, or copying. 
Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software 
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under 
vendor’s standard commercial license. 


Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information 
in this document is subject to change without notice. 


THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY 
KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH 
RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, 
INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT 
LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION OR LOSS 
OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY 

OF SUCH DAMAGES AND WHETHER IN AN ACTION OF CONTRACT OR TORT, INCLUDING 
NEGLIGENCE. 


The limited warranties for Compaq products are exclusively set forth in the documentation accompanying 
such products. Nothing herein should be construed as constituting a further or additional warranty. 


Contents 


About This Guide 


1 Overview 


1.1 LSM Object Hierarchy .............cccecee cece eee eee teeter eae eee 1-2 
1.1.1 LSM’ DISKYsticc.netiesh cake ds ateleelee cues Catedivene seer dein am 1-2 
1.1.2 DISK GIOUP ey sasieee dee viaden ols Sey plaenieee Geass aes heater 1-5 
1.1.3 SUBOISK: a wiiwcoseces ive Sisciee oe dye ed oad deeded denen one 1-5 
1.1.4 PI OX isdvvcdenceeanietthiatey vensaa vader tacensoeciaat a enpiaedar ean 1-6 
1.1.4.1 Concatenated Data PI@X ........... cece cece teeta ees 1-7 
1.1.4.2 Striped Data Plex ........ cece eect eee eee eee ena 1-9 
1.1.4.3 RAID 5 Data Plex 2.0.0.0... cece cece eee eee eee seat eae eae eae 1-12 
1.1.5 ESM: VOIOINGS: ceciteasieiiisald hide Aseecrotaenvcwlontady dans oss 1-13 
1.2 eS Mi RCRD ACES: a cles tsiuctahn tater attatclca ala tac atta sa alata aati ole alas ia 1-14 
1.2.1 LSM Command: MtGtace sie site ieee tad ss aaa tain 1-15 
2 Planning LSM Volumes and Disk Groups 

2.1 Planning LSM VolUMES .............: ce eee eee eee eee ee eta eeee 2-1 
2.1.1 Planningan LSM Volume That Uses a Concatenated Plex 2-4 
2.1.2 Planning an LSM Volume That Uses a Striped Plex ....... 2-5 
2.1.3 Planning an LSM Volume That Uses a RAID 5 Plex ....... 2-6 
2.2 Planning Disk GroupS .............c cee eect eee eee eee teeta eee 2-7 
2.3 Identifying Unused Storage DeVICES ............ cece cece eee 2-10 
2.3.1 Using the Disk Configuration GUI to! dentify Unused 

DISKS. rien fasan nano e nn yue hate fe? aud itera ea ahiiined ae 2-11 
2.3.2 Using Operating System Commands to | dentify Unused 

DISKS ccncteade (tagn eeu ettd ance Otte eutn Sopane ht Boaaaenee ee eas 2-12 
2.3.3 Using the voldisk Command to Identify Unused Disks .... 2-12 

3 Installing or Upgrading the LSM Software 

3.1 Preparing toUpgrade LSM ......... cece cece eee nett eee eee eee eee 3-1 
3.1.1 Increasing the Size of BCLS ............ceceeee eee eee ee eee eee 3-1 
3.1.2 Deporting Disk GroupS ............. cece eee eee eee eee eae eee 3-2 
3.1.3 Backing Up a Previous LSM Configuration .................. 3-2 
3.2 Installing or Upgrading LSM .............cccecee tees e eee eee eee eee 3-3 


Contents _ iii 


3.3 Installing the LSM License ..............cccee cece eee eee eee teens 
3.4 Performing Postinstallation TaskS ............:::eeceeeeeeee tees eee 


3.4.1 
3.4.1.1 
3.4.1.2 
3.4.1.2.1 
3.4.1.2.2 
3.4.1.2.3 
3.4.1.2.4 
3.4.2 
3.4.3 
3.4.3.1 
3.4.3.2 
3.4.3.3 
3.4.3.4 
3.4.3.5 
3.4.3.6 
3.4.3.7 
3.4.3.8 
3.4.4 


3.4.4.1 
3.4.4.2 
3.4.4.3 
3.4.4.4 


InitialiZing@eSM: -vesere Khe ade eet ea ahead Aneeeeaa eee eos 
Verifying That LSM Is Initialized (Optional) ........... 
LSM Files, Directories, Drivers, and Daemons ......... 

LSM Pil@S. sav siaoved cece vacciapeae ete eadvuncauied cea wiieas 


LSM D@@MoOns .........ccce cece cnet eee eee eaeeeeeeeeeae 
Optimizing the LSM Configuration Databases (Optional) 
Creating an Alternate Boot DiSk ...............ccceeeeeeeee ees 

R@SUFiCtIONS ........ ccc cece ee ece cess eeeeeeeeeeeeseneeeeeaeees 
Encapsulating Boot Disk Partitions .................0006: 
Creating Mirror Plexes for Boot Disk Volumes ......... 
Displaying Information for Boot Disk Volumes ......... 
Displaying AdvFS File Domain Information ............ 
Displaying UFS File System Information ............... 
Displaying Swap Volume! nformation ................+45 
Unencapsulating the Boot Disk ................:eeeeee eee 
Configuring the Automatic Data Relocation (H ot-Sparing) 
Features snk cise cele Jaca sehen aula alee Selma ees Ghiy iis 
Enabling the Hot-Sparing Feature ............::::::00ees 
Configuring and Deconfiguring a Spare Disk ........... 
Setting Up Mail Notification for Exception Events .... 
Moving Relocated LSM Objects ............:..cceeee eee ees 


4 Creating LSM Disk Groups and Volumes 
44 Creating Disk GrOoupS ............ cc cece eee eect eee eee ee tenn ees 


4.1.1 


Displaying Disk Group Information ...............::cceeeeee es 
Creating a Disk Group or Adding Disks toa Disk Group .. 
Creating a Backup Copy of the Disk Label Information ... 


4.2 Creating an LSM Volume for New Data ...............:eeeeeeeee ee 


Creating an LSM Volume Using a Concatenated Plex ..... 
Creating an LSM Volume Using a Striped Plex ............. 
Creating an LSM Volume Using a Striped Plex (on 

Different BUSES): ifeeveiiete cen ddeccieieesacdga ween eevee deandaraees 
Creating an LSM Volume Using a RAID 5 Plex ............. 
Creating an LSM Volume Using a RAID 5 Plex (on 

Different: BUSES): vcecadeieds Sea iiss enethieedievnde, Oued vee 
Creating an LSM Volume for Secondary Swap Space ...... 


4.3 Configuring File Systems toUseLSM Volumes ...............4. 


iv Contents 


Creating a UFS File System on an LSM Volume............ 


Ge ee Ge eS ge ga aoe ae 


lo 
Lo 
NOOR ADH KH OODOOAONNOAA HA 


WWWWWAWAWW WwW 
PEE EEE EEL 


4.3.2 Creating an AdvFS File Domain on an LSM Volume....... 4-15 


4.4 Creating an LSM Volume for Existing Data .................:0005 4-16 
4.4.1 Encapsulating Disks and Disk Partitions .................... 4-16 
4.4.2 Encapsulating AdvFS File Domains ..............:::::eeee eee 4-17 


5 Managing LSM Objects 


5.1 Managing LSM DISKS ...........:ccccee eee e cette eee eee eee eae eee 5-1 
5.1.1 Creating an LSM Disk ........... cece cece eect eect eee eens 5-1 
5.1.2 Displaying LSM Disk Information ................cceceee eee 5-2 
5.1.3 Renaming an LSM DISK ............:ec cece eee eee eee eee 5-3 
5.1.4 Placing an LSM Disk Off Line ..............ceceeeeee eee eee 5-3 
5.1.5 Placing an LSM Disk On Line .............:eceeeeee eee eee eee 5-4 
5.1.6 Moving Data from an LSM Disk .............ccceeeee eee ee eee 5-4 
5.1.7 Removing an LSM Disk from LSM Control .................. 5-4 
5.2 Managing Disk Groups ............. cece cece eee eee eae eae eee 5-5 
5.2.1 Displaying Disk Group Information ...............:::eeeeee ee 5-5 
5.2.1.1 Displaying All LSM DiskS ..............:c ccc eee ener eee eee 5-5 
5.2.1.2 Displaying Free Spacein Disk Groups ................+.5 5-6 
5.2.1.3 Displaying the Maximum Size for an LSM Volumeina 
DISK: GIOUP 25 sce ectieves sex etd teetne diet Sandes sc eedteae ee 5-6 
5.2.2 Creating a Disk Group ............ cee ceee eect eee eee teat ees 5-6 
5.2.3 Adding a Disk toa Disk Group .............:ecce cece eee eee eee 5-7 
5.2.4 Deporting a DiSk Group ............ cece eee eee eee teeta e eee 5-7 
5.2.5 Importing a DiSk Group ........... 0. cece eee eee eee eee eae eee 5-8 
5.2.6 Moving a Disk Group to Another System .............::00005 5-8 
5.2.7 Removing an LSM Disk froma Disk Group ..............+.. 5-9 
5.3 Managing the LSM Configuration Database ..................... 5-10 
5.3.1 Backing Up the LSM Configuration Database .............. 5-10 
5.3.2 Restoring the LSM Configuration Database from Backup 5-12 
5.3.3 Changing the Size and Number of Configuration Database 
COPIES panies esis Jaddee scanner Lelie areas tae we Seeniatgee ail wel 5-13 
5.4 Managing VOIUMES ...........ccceeee cece e eee eee teen e eae 5-14 
5.4.1 Displaying LSM VolumelInformation .............:::0:eeeeeee 5-14 
5.4.2 Backing Up an LSM Volume .............0::seeeeeee tenet teens 5-15 
5.4.2.1 Backing Up a Volume with a Single Concatenated or 
Striped: Plex: ..ccscsediisecvh cobb ie anataieedna tec Seeders 5-16 
5.4.2.2 Backing Up a Volume with Mirror Plexes ............... 5-17 
5.4.2.3 Backing Up a Volume with a RAID 5 Plex .............. 5-18 
5.4.3 Restoring an LSM Volume from Backup .............:::0005 5-18 
5.4.4 Starting an LSM Volume ............:.c:ceeee eee eee eee eae eee 5-19 
5.4.5 Stopping an LSM VolUMe ............ cece eee e eee ee eae eee 5-19 


Contents v 


5.4.6 Removing an LSM VolUME ............ 0c cece eect teeta eee 5-20 


5.4.7 Recovering an LSM Volume ............:cceeeeee eect eee eee 5-21 
5.4.8 Renaming an LSM Volume ...........0::ccceeeee eee ee eee eee 5-22 
5.4.9 Changing LSM Volume Permission, User, and Group 

Attributes: seo ccccccevivedig pent n cccb needs s tee eey yeti coebienec eos 5-22 
5.5 Managing PICX€S ..........ccce cece eee ee eaten ene ena eee 5-22 
5.5.1 Displaying Plex Information ..............c::eceeeeee eee eee eee 5-22 
5.5.1.1 Displaying General Plex Information .................+45 5-23 
5.5.1.2 Displaying Detailed Plex Information ................... 5-23 
5.5.2 Adding a Data Plex ......... cc cceeee cece e tent eee eee enae ees 5-24 
5.5.3 Adding a Log PIX ...........cc ccc ece cnet eee eee eee eeeeenae ene 5-24 
5.5.4 Moving Data toa New PIEX ......... ce cceeee eect eect e eee 5-24 
5.5.5 Reattaching a PICX «0.0... cece cece eee e ened 5-26 
5.5.6 REMOVING a PICX 0... cece ee eee 5-26 
5.6 Managing SubdiskS .............. cece cette eect eee eee eee eee eee 5-27 
5.6.1 Displaying Subdisk Information ...............::cceeeeee eee eee 5-27 
5.6.1.1 Displaying General Subdisk Information ............... 5-27 
5.6.1.2 Displaying Detailed Subdisk Information ............... 5-28 
5.6.2 J OINING SUDGISKS «2... .. icc ee teeta 5-28 
5.6.3 Splitting SUDGISKS 2.1.0... cece eee eee eee 5-28 
5.6.4 MOVING: SUBOISKSi525 se eet eciepsh eta ica dobatu bag atabeand tke 5-29 
5.6.5 Removing a SUBCISK ............ cece cece teeta eee eed 5-29 


6 Troubleshooting 


6.1 Monitoring LSM ............c cece eee eee eens eee eee teen nae eee 6-1 
6.1.1 Monitoring LSM Events ...........::ccccecee eee tenet eee eee e eee 6-1 
6.1.2 Monitoring Read and Write Statistics ................. ee 6-2 
6.1.2.1 Displaying Read and Write Statistics .................... 6-2 
6.1.2.2 Displaying Failed Read and Write Statistics ............ 6-3 
6.1.3 Monitoring LSM Object States ..............:ceeeeeeeee eee eee 6-3 
6.1.3.1 Kernel States sei cectcagacvemc gee ren nlaeeeeetl ancedbwee arta 6-4 
6.1.3.2 ESM States cdiienriiisetaieiittasehieeveretace Sunes .cs 6-4 
6.2 Missing or Altered sysconfigtab File ............:..cccceeeee eee ees 6-7 
6.3 LSM Startup and Command Problems .............::00ceeee eee eee 6-7 
6.3.1 Checking the vold Daemon ............:ccceeee cence eee teat eee 6-7 
6.3.2 Checking the voliod Daemon ............cccecee eee ence eee ees 6-8 
6.4 Solving Problems with LSM VolUM6S ............:.0:ceeee eee eee es 6-8 
6.4.1 Insufficient Space to Create a Volume .............::c cece eee 6-9 
6.4.2 Starting a Disabled Volume ..............:ccceece cece eens eens 6-10 
6.4.3 Recovering Unstartable Nonredundant Volumes ........... 6-10 
6.4.4 Recovering Volumes with Mirror Plexes ...........::0:eeeeeee 6-12 


vi Contents 


6.5.6.1 
6.6 
6.7 


Recovering a Volume with No Valid Plexes .............. 6-12 
Recovering a Volume with One Valid Plex ............... 6-13 
Recovering a Volume After Loss of Configuration 
Databases seatcicctse idee tieh vi suc idaees ceandlianshate dete 6-13 
Recovering Volumes with a Failed RAID 5 Plex............. 6-14 
Recovering a RAID 5 Plex from Multiple Disk 
PAllURGS! 2 isasitects Sen iatiat hae. aaarauad ss ecdeaminne sear 6-14 
Recovering a RAID 5Log Plex ..........e cee e cece eee 6-16 
Checking the Status of Volume Resynchronization ......... 6-18 
Clearing Locks on LSM VolUMES ............:cccee eee e eee eees 6-19 
Solving Disk ProbleMs ............:cc cece eee cece ee ee ee eee eens 6-19 
Checking Disk Status ............ cece cee ee eect eee eee enna 6-19 
Recovering a Stale SUbdISK ........... cc ccce cece eee eee eee eee 6-20 
Recovering Volumes After a Temporary Disk Failure ...... 6-20 
Moving a Volume Off a Failing Disk .................: eee 6-21 
Replacing a Failed DiSk .............cceccecee eect teen eee eee 6-21 
Recovering from a Boot Disk Failure ..............:.::::eeeee 6-23 
Replacing a Failed Boot Disk ..............::cc cece eee eee 6-23 
Problems Importing a Disk Group ............0::eeeeeeee eee e eee 6-24 
Removing the LSM Software ............::cccceeeeeee eens e eee eae ees 6-25 


7 Error Messages 


7.1 
7.2 


Volume Daemon Error M@SS@Q6€S .........::e ccc eee eee eee ee teat eee 7-1 
Kernel Error Me@SSQG@S ....... 2.0: c cece eee e eee eee teeta ee ee ete e ees 7-16 


A_ The Storage Administrator 


A.1 


OVErVIOW. bice ves cle cca eked eee OL ide cee cee deunenecek ee eal A-1 
Installing and Starting the Storage Administrator ......... A-2 
Storage Administrator Main Window .............:::::eeeees A-3 

Performing Tasks with the Storage Administrator .............. A-5 
Selecting ObjectS .......... cece cece eee eee e eee ee ee etna eee eed A-5 
Using the Menu Bar ......... cc ee eee eee eee eee e eae A-5 
Using the Right Mouse Button to Display a Pop-Up Menu A-5 
Using the Command Launcher ............:::cceeeee eee eee eee A-6 
Exiting the Storage Administrator .................::ceeeeeeee A-6 

Managing DISKS ........... 2c: ceccee eee cece eect ete ence e ena A-6 
AddINg'a DISK x. viene coc decd oi sabe eat dand aaa easeur ies heen: A-6 
Evacuating aDISK 2.20... ... cece cece e eee eee teeter eed A-8 
Mirroring ADISK .......... cc cece eee ee eee eee eee e eta A-9 
Placing a Disk On Line ..............ceeeeeee eect e eee eee A-10 
Recovering Volumes on ADISK  ........ eee cece eee eee eee eee A-11 


Contents _ vii 


A.3.6 
A.3.7 
A.3.8 
A.3.9 
A.3.10 
A.4 
A.4.1 
A.4.2 
A.4.3 
A.4.4 


viii Contents 


Removing a Disk from an LSM Disk Group ..............+.. 


Renaming a Disk ............::c:eeeeee neers 
Replacing a DiSk .............eceeeeeee eee ee 
Scanning for New DiskS .................5. 
Taking a Disk Off Line .................... 
Managing Disk Groups ............:::eeeeeee eee 
Adding a Disk toa Disk Group .......... 
Creating a Disk Group ................6455 
Deporting a Disk Group ................. 
Importing a Disk Group .............::0065 
Destroying a Disk Group ................ 
Moving aDisk Group ..............0000e 
Recovering Volumes in a Disk Group ... 
Renaming a Disk Group ................ 
Managing SubdiskS ..............::eeeeeeee eee 
J Oining Subdisks ............. cece eee 
Moving aSubdisk ..............::eeee eee 
Removing a Subdisk ..............:.0:eeaee 
Splitting a Subdisk ............... cee 
Managing VOIUMES ...........:.ceeeeeee eee eae 


Analyzing Activity on Volumes, Disks, and Subdisks ...... 


Adding a File System toa Volume ...... 
Adding a Log toa Volume ..............055 
Adding a Mirror toa Volume ............. 
Disabling a Mirror ina Volume .......... 
Repairing a Mirror ina Volume.......... 
Checking a File System on a Volume ... 
Creating a Copy of Volume Data ......... 
Creating a VOIUME ...........cce cece e eee 


Mounting a UFS File System on a Volume .............00005 
Preparing to Restore a Volume from Backup ..............55 


Recovering a VOlUME ...........eeeeee eee eee 
Removing a VolUMe ............::ceeee eee 
Removing a Log froma Volume ........... 
Removing a Mirror from a Volume ....... 
Renaming a Volume .............:00 eens 
Resizing a VOIUME ............cce eee eee eee 
Starting a VOIUME ............. cece eee eee es 
Stopping a VOIUME ......... 6. . cece eee eee 


Unmounting a File System on a Volume 


A-11 
A-12 
A-13 
A-14 
A-14 
A-14 
A-14 
A-15 
A-16 
A-17 
A-18 
A-19 
A-20 
A-20 
A-21 
A-21 
A-22 
A-24 
A-24 
A-25 
A-26 
A-28 
A-30 
A-31 
A-32 
A-33 
A-34 
A-35 
A-35 
A-37 
A-38 
A-39 
A-40 
A-40 
A-41 
A-41 
A-42 
A-43 
A-44 
A-44 


B Customizing the Storage Administrator 


B.1 Tracking Storage Administrator Activities ................:0088 B-1 
B.1.1 Command Log File ...........::ecceeee cece e cece e eee teeta eens B-1 
B.1.2 Access LOG File ..........ecee cece eee eee eee e eee e tees eee teae ene B-2 
B.1.3 Server LOG File ..........cccee eee e eee ene ee eee ee ee etna eee e eed B-2 
B.2 Working with Dialog BOXES ............::eccee eect eee eee ee teat ees B-3 
B.2.1 Specifying Objects in Dialog BOXES ..............cceeeee eee ees B-3 
B.2.2 Specifying Object Sizes in Dialog BOXés ................:00685 B-4 
B.3 Viewing Objects and Object Properties ............:.cceeeee ener B-4 
B.3.1 Main: WINdOW'..s.cssedenedanetonte tad aat tea itn Sed B-4 
B.3.2 Volume Layout Details WINdOW ..............:cceeeeeee eee ees B-5 
B.3.3 Object Properties Dialog BOXeS ......... cee ceeeee eee eee eee B-6 
B.3.4 User Preferences Dialog BOX ...........:.c:ceeeeeeee tenet teens B-7 
B.3.4.1 General Preferences .........:.ccceeee eect eee eee eee ena B-9 
B.3.4.2 Main Window Preferences ...........0:::eeeeeeeeeee eee e eee B-9 
B.3.4.3 Font Preferences ..........0cceccee cece eee teeta etna ee nee ees B-10 
B.3.4.4 Color Preferences ..........cc ccc cece eee eee tees eae eeaaes B-10 
B.3.4.5 Geometry Preferences ........:cc cece eee eee ee eect eee eenaes B-11 
B.3.4.6 Object Tree/Object Table Preferences ...........:::::00e B-11 
B.3.4.7 Toolbar Preferences .........:cc cece eee eee eee ee neat eae ees B-12 
B.3.4.8 Layout Details Preferences .............:ceeeeee eee eee eee B-12 
B.3.5 Alert Monitor Window .............:ccccecee cnet eee eee eeeae ees B-12 
B.3.6 Object Table Copy WiINdOW ............:cc cece cece eee etna eee B-13 
B.3.7 Search WINdOW ........ cc ceceete eee e ee eee eee eee teat ene ete ed B-13 
B.3.8 Task Request Monitor Window .............:0cceeeee eee e eee B-14 
B.4 Shortcuts and Other Operations .............:ccceece cece eee eee aes B-15 
B.4.1 Sorting Objects: oo. isseesiee eee eedee estas ed gegen sees leetes B-15 
B.4.2 Clearing an Alert ........ 00. cece cece ene eee tees eee eeeae tees B-15 
B.4.3 Keyboard Shortcuts ............:cceceeeeee eee eee eee eeeee eta ened B-15 
B.4.4 Docking the Toolbar and Command Launcher .............. B-16 
C_ Using the voldiskadm Menu Interface 
C..1 Starting the voldiskadm Menu Interface ..............:::eeee eae C-1 
C.2 Disk Management ...........::cccceee eect eee eee eee ete eee e eae eed C-2 
C.2.1 Initializing a DiSk ........ cece eee eee eee eee C-2 
C.2.2 Displaying Disk Information ............:.c cece cece C-4 
C.2.3 Adding a Disk toa Disk Group ............:ceceeee eens eee ees C-5 
C.2.4 Moving Volumes from a DiSK ...........::ccceeeee eee eee teens C-7 
C.2.5 Removing a Disk from a DiSk Group .............0::eeee eee ee C-8 
C.2.5.1 Removing a Disk Without Replacement ..............+.. C-8 
C.2.5.2 Removing a Disk for Replacement ............::::: eee C-9 


Contents ix 


Replacing a Failed or Removed Disk ..............::cee seen 
Disabling a DiSKk ............ cece cece eee eee eee eee e eae 
Disk Group Management ............:0cc cece eee eee eee teeta eens 
Importing a DiSk Group ..........0 0 ccc eeeee eee eee e eae eed 
Deporting a Disk Group ............. cece eect eee eee teed 
Mirror Volume Management ............:0cceeee cnet e eee eee eae eee 
Exiting the voldiskadm Menu Interface ............:..::cee eee 


D The Visual Administrator 


Starting the Visual Administrator ...............:c cece eee eee es 
The Visual Administrator Main Window .................0065 
Default: ViCWS? i ceiaansa ced Conaaraaance beaten ev as watlacia ass 
User-Created ViCWS ........cccccc cece eeceeeeeeeeeseeeeeeeees 

The View of rootdg WINdOW ............. ccc eee eect eee eae ees 


D.1 
D.1.1 
D.1.1.1 
D.1.1.2 
D.1.2 


Mouse Buttons .... 


Icons for LSM Objects ......... 00. cecce cee eee eects e eae eee 
Icon CharacteristiCS ...........ccceceee cece eee e teeta eee ened 
Manipulating ICONS ............. ccc cece eee eee eee eee eee 


Pull-Down Menus . 


Form Error M@SS€Q6S ..... 0... cee eeee eee eee ee eee tenet eee e ees 


Error and Warning 
Help Windows ..... 


MGCSSAGES: vitncllieier ia eenedd onde peaeedldies 


E Using the Visual Administrator 


E.14 
E.1.1 
E.1.1.1 
E.1.1.2 


x Contents 


Managing Volumes 
Volume M enus 


BasiCOpsS Menu .........ceecee cece eee eee eee eee teens 
Advanced-Ops Menu .........0:::cceeeee cent eee e eee ea eens 


Volume F orms 


BasiGCOps Forms ........... cece cece eee eect eee eae eee 
Advanced-Ops FOrMms .........0::ccceeee cent eens eee e eae eee 
Volume Properties FOrM ..........::ccceeee tees cease eeeeeeae eas 


Plex Management . 
Plex Menus .... 
Plex Forms .... 
Plex Properties 


FORMS nss'd cit tannaaahl Gout tee oe ears: SG 


Subdisk Management ...........:::ec cece eee cece e eee need 


Subdisk Menus 
Subdisk Forms 


Oo 


Cie ee ae 
RRWNMNDND = 


I 
NNNNNOO 


oe EN ee Rae 


a 
MANADNA- + + 


mmm 
Eid 


E.3.3 Subdisk Properties FOrMS ..........:.ccceeee cece e eee eee eae eee E-25 


E.4 Disk Management ...........:cc cece cnet eee eee eee eae ene e eee E-27 
E.4.1 DiSk M@NUS  aa..cgecee eve ceen ec eevv eden e eee eebee sees eee nes E-27 
E.4.1.1 BasiCOps Menu ....... cee ecceeee cece ee eee teeta eee eens E-27 
E.4.1.2 Advanced-Ops Menu ...........:ccceeee eens tenet eeaeeae ens E-28 
E.4.2 DISK*F.OPMSiee2.cucsieenrd oon. tb iltaeeeelfegtel piseesesie bates E-30 
E.4.3 BasiCOps Forms ..........:.ccceeeee eect ee eee teeter need E-30 
E.4.3.1 Advanced-Ops Forms ..........::cccceeee eee eens tenet teens E-31 
E.4.4 Disk Properties FOPMS ..........:. cece cee eee eect eee eee eae eed E-34 
E.5 Disk Group Management ..............0c cece eee eee eee eee teens E-36 
E.5.1 Disk Group MENUS ........ 00. c cece eee cee eee eee eee eee teed E-36 
E.5.2 Disk GroUp FOrMS ............ cece cece eee eee eee tenet e en ae eed E-39 
E.6 Projection AnalySiS ............ccceeee eee ee eee eee eee encanta eed E-40 
E.6.1 PLOjQCtiON: oy ied chae wie eden ewe vied ed deaaee seve ee eee cee ed E-41 
E.6.2 Projection MenUS ........... ccc ee eect eee eee eee eee e etna e eta e eed E-41 
E.6.3 Projection Relationships ...............cccceeeee eect eee eee eee E-42 
E.7 ATIALYSIS pcecsiea trea bdh Hive ee bia wed ested Ade eed Hereaa ne bot eat baw tee E-42 
E.7.1 Analysis M@nusS ............. 0: cce eect eee tees eee eee ee eens eae eed E-43 
E.7.2 Anal SiS: FOnms:.eaceccciel ttucoteehebtanticeeeis ateniar tele E-43 
E.7.3 Anal YSIS TAD 6) 2ai0os duet tana eiaiane-nupinheree dd temeeetad E-45 
E.8 UFS Management ...........:ecceeeeeee eee eee eee eee eeeeeneeee eee E—45 
E.8.1 File System MENUS .........0::eccee eee eee eee eee ected E-46 
E.8.2 File System FOrMS ........0cceceee eee eee eee eee eect eee eae eed E-48 
E.8.2.1 BaSiGOps Forms: 22:02 esc. se des sites ee dgncbees rece eedeeket E-48 
E.8.2.2 File Systems Properties FOrM ..........::c:seeeeeee eee eee E-52 

Glossary 

Index 

Examples 
3-1 Sample Mail Notification ............. cece cece eee eee ee eee eee 3-20 
3-2 Complete Disk Failure Mail Notification ...................:005 3-21 
3-3 Partial Disk Failure Mail Notification .................c eee 3-21 
3-4 Successful Data Relocation Mail Notification .................. 3-22 
3-5 No Spare or Free Disk Space Mail Notification .................. 3-22 
3-6 Data Relocation Failure Mail Notification ...................05 3-22 
3-7 ~~ Unusable Volume Mail Notification ................cceeeeeeeee eee 3-23 
3-8 Unusable RAID 5 Volume Mail Notification ...................... 3-23 
4-1 LSM Volume Attribute Defaults File ...............cceeeeee eee 4-6 


Contents xi 


Figures 


xii 


14 


MOUMOMNMND + 
be ahedesche iy Abe ae el Eile Sa 
—_ 


NOOROMHAOAHRAWANA + 


Ge GF 0) Eee 9 9... 


pe ae eg 


Contents 


Typical LSM Hardware Configuration ..............cccceeeneeeees 
LSM Sliced DiSk 0... 0... cece eect eee eee neta e eee eed 
LSM Simple Disk ............ ccc eect eee e eee eee ee etna e ene eeee 
LSM Nopriv DiSk 2.0.0.0... 0 cece eee eee eee eee eee eterna eens 
Concatenated Data Plex 0.00... eec cece cece eee ee eee eee ee teen ees 
Concatenated Data Plex with One Mirror ............::0::eeeeeee 
Writing Data toa Striped Plex ......... cece cece eee eae eee 
Incomplete Striped Data Plex ......... 0. cece eee eee eee eee eee eee 
Striped Data Plex with One Mirror ..............:ccceeee eee eee 
Data and Parity Placement in a Three-Column RAID 5 Data 

PIOX- Sia tear bebe csamarana cas davuduccoth sen ctamiactaseta evimanieosehile caine 
Using LSM Volumes Like Disk Partitions ................000eeees 
Worksheet for Planning a Volume with Concatenated Plexes . 
Worksheet for Planning a Volume with Striped Plexes ......... 
Worksheet for Planning a Volume with a RAID 5 Plex ......... 
Worksheet for Planning rootdg Disk Group ..............:600008 
Worksheet for Planning Additional Disk Groups ................ 
Worksheet for Planning Disk Groups (Completed Example) ... 
The Storage Administrator Main Window .............ccseeseeees 
Typical Storage Administrator Dialog Box ............ccceeeeee ees 
Volume Layout WiNdOW .............:c cece eee nett ee eee eee e teat eee 
Volume Properties Dialog BOX .........:.c:cecee eee e cnet eee tenes 
Preferences DialOQ BOX ............: cece cece eee eee e tees eee teen ees 
Alert Monitor WiINdOW ............. ccc cee eeee eee eee eee eee eee e eed 
Search Dial0g BOX ..........cceceeee eee eee eee ee ee ete eens 
Task Request Monitor WINGOW ...........ccccceceeeeeeeeeeeeneeeees 
Main Menu for the LSM voldiskadm Interface .................4. 
Visual Administrator Main Window ................::::eeeeeeee eee 
View of rootdg WiNdOW .............::c cece cece nett ee eee eee e et eae ees 
Icons That Represent LSM Objects ............::ccceeeeeeee eee eee 


LSM Commands ..........ccccceeeeeeeeeeeeeeeeeceeeeeeeeeeeeeeueeuees 
LSM Volume Attributes with No Default Values ................ 
LSM Volume Attributes with Default Values ..............0.00088 
Choosing a PlEX TyPe@ ...... cee cce cece cece eect eee eee eeeeneae ees 
LSM Device Special FileS .............c cece cece e eee ee eae 
LSM /etc/vol/ SUbdIreCtOrieS ........... cece cece cece eee ae eee eeeeeas 
LSM Block and Character Device Subdirectories ................ 


nian 
OD O11 Ww & 


wow 
Hud 
awn-A-+-a4ahkwa 


Peeper rert 


D-2 


Common LSM Volume Attributes ..............cceeeee eee eee eee 4-6 
Common volstat Command Options .............:::eceeeeee eee eees 6-2 
LSM Volume Kernel States (KSTATE) .........ccccc cece cece cena 6-4 
LSM Volume States (STATE) .........cccceceeeeeeeeeeeeeeeeeeeeeees 6-5 
LSM Plex States 2.0.00... cece eee teen eee eee ence etna e ene e eee 6-5 
LSM Subdisk States ............ cece cece eee ected 6-7 
vold Messages and Solutions ............. cece eee eee eee eee e teat ees 6-8 
Keyboard ShortcutS ...........ccceeeeee eee eee eee eee eee teen e eee B-16 
Main Window Keyboard Shortcuts ............::::cceeeeeeee eee eee B-16 
Accessing the Default View WINdOW .............::ceeeeeee eee ees D-2 
Default Mouse BUttONS ............ cece cece eee eee eee e eae D-3 
Drag and Drop Operations ...............:cee eect cette ee eee eens D-6 
Help Menu Options .............. cece cece eee eee eect ee eta eee D-8 
Create VolUMe MENU ...... 2. ccc cece e eee e eee teen ee eae eens E-2 
Add Mirror Menu Options ..............0 cece eee ee eee e eee eee eae eee E-3 
PrOJSCtlON: Tab Oi. 2222 nced eetaeeermen she ttanaseme teber deen nhiiveta dns E-42 
Analysis: Table wi ticscnccte se evremiaids fees punuiasale dev yasieeingge dees eile E-45 


Contents xiii 


About This Guide 


This guide describes how to configure and manage disk storage using the 
Logical Storage Manager (LSM) software. It includes information on LSM 
concepts and how to plan, set up, monitor, change, and troubleshoot an LSM 
configuration. 


Audience 


This guide is intended for anyone who needs to configure and manage 
storage devices under LSM control. To use this guide you must be able to 
administer a system running the Tru64 UNIX operating system software 
and its storage devices. 


New and Changed Features 


TheLSM guide has been extensively revised and reorganized to simplify the 
presentation of material and place more emphasis on performing tasks. 


Organization 


This guide contains the following chapters and appendices. 


Chapter 1 Describes LSM features, terms, and concepts, and 
introduces the available interfaces to LSM. 


Chapter 2 Provides worksheets to aid you in planning 
your LSM configuration. 


Chapter 3 Describes how to upgrade a system with an existing 
LSM configuration, or install LSM for the first time 
as part of a system upgrade or installation. 


Chapter 4 Describes how to create LSM volumes, and how 
to encapsulate existing data or file systems 
into LSM volumes. 


Chapter 5 Describes common management tasks for LSM objects. 
Chapter 6 Describes how to recover from problems and how 

to replace disks under LSM control. 
Chapter 7 Describes LSM error messages and solutions. 
Appendix A Describes how to install and start the Storage 


Administrator GUI, and how to manage LSM 
objects using this interface. 
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Related Documents 


Xvi 


Appendix B 


Appendix C 


Appendix D 


Appendix E 


Glossary 


Describes how to track Storage Administrator activities, 
how to use the Storage Administrator, and how to 
customize the Storage Administrator GUI. 


Describes how to manage LSM objects using the 
voldiskadm menu interface. 


Describes how to start the Visual Administrator 
(dxlsm) interface, and describes its windows, 
icons, and mouse operations. 


Describes how to manage LSM objects with the 
Visual Administrator (dx1sm) interface. 


The following operating system documents provide information related to 


LSM: 


e¢ Installation Guide describes how toinstall the LSM software. 


e Reease Notes describe LSM problems and solutions that might not be 
documented elsewhere. 


e« System Administration describes general storage administration. 


¢« System Configuration and Tuning describes how to plan, configure and 
tune storage devices. 


¢ AdvFS Administration describes how to use the AdvFS software with 


LSM. 


¢« Cluster Administration describes how to configure LSM in a TruCluster 


cluster. 


Icons on Tru64 UNIX Printed Books 


The printed version of the Tru64 UNIX documentation uses letter icons on 
the spines of the books to help specific audiences quickly find the books that 
meet their needs. (You can order the printed documentation from Compaq.) 
The following list describes this convention: 


DUVDN QA 


About This Guide 


Books for general users 

Books for system and network administrators 
Books for programmers 

Books for device driver writers 


Books for reference page users 


Some books in the documentation help meet the needs of several audiences. 
For example, the information in some system books is also used by 
programmers. Keep this in mind when searching for information on specific 


topics. 


The Documentation Overview provides information on all of the books in 
the Tru64 UNIX documentation set. 


Conventions 


This guide uses the following conventions: 


file 


cat(1) 


A number sign represents the superuser prompt. 


Boldface type in interactive examples indicates 
typed user input. 


Italic (slanted) type indicates variable values, 
placeholders, and function argument names. 


In syntax definitions, brackets indicate items that 
are optional and braces indicate items that are 
required. Vertical bars separating items inside 
brackets or braces indicate that you choose one item 
from among those listed. 


In syntax definitions, a horizontal ellipsis indicates 
that the preceding item can be repeated one or 
more times. 


A cross-reference to a reference page includes 
the appropriate section number in parentheses. 
For example, cat(1) indicates that you can find 
information on the cat command in Section 1 of 
the reference pages. 
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Overview 


The Logical Storage Manager (LSM) software is an optional integrated, 
host-based disk storage management application. LSM uses Redundant 
Arrays of Independent Disks (RAID) technology to enable you to configure 
storage devices into a virtual pool of storage to protect against data loss, 
maximize disk use, improve performance, provide high data availability, and 
manage storage without disrupting users or applications accessing data on 
those disks. 


This chapter introduces LSM features, concepts, and terminology. The 
volintro(8) reference page also provides information on LSM terms and 
commands. 


LSM allows you to manage all of your storage devices, such as disks, 
partitions, or RAID sets, as a flexible pool of storage from which you create 
LSM volumes. You configure new file systems, databases, and applications, 
or encapsulate existing ones, to use an LSM volume instead of a disk 
partition. The benefits of using an LSM volume instead of a disk partition 
include: 


¢ Data loss protection 


LSM can automatically store and maintain multiple copies (mirrors) of 
data or data and parity information. If a storage device fails, LSM: 


- Continues operating using either the mirrors or the remaining data 
and parity information, without disrupting users or applications, 
shutting down the system, or backing up and restoring data 


- Can automatically transfer the data from the failed storage device 
to a designated spare disk, or to free disk space, and send you mail 
about the relocation 


You can also use LSM to encapsulate the boot disk partitions into LSM 
volumes, then create mirrors of those volumes. By doing so, you create 
copies of the boot disk partitions from which the system can boot if the 
original boot disk fails. 


« Maximize disk usage 


You can configure LSM to seamlessly join together storage devices to 
appear as a single storage device to users and applications. 


¢« Performance improvements 
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You can configure LSM to separate data into units of equal size, then 
write the data units totwo or more storage devices. LSM simultaneously 
writes the data units if the storage devices are on different SCSI buses. 


¢ Data availability 


You can configure LSM in a TruCluster environment. TruCluster 
software makes AlphaServer systems appear as a single system on the 
network. The AlphaServer systems running the TruCluster software 
become members of the cluster and share resources and data storage. 
This sharing allows applications, such as LSM, tocontinue uninterrupted 
if the cluster member on which it was running fails. 


1.1 LSM Object Hierarchy 


LSM uses the following hierarchy of objects to organize storage: 


¢ LSM disk—An object that represents a storage device that is initialized 
exclusively for use by LSM 


¢ Subdisk—An object that represents a contiguous set of blocks on an LSM 
disk that LSM uses to write volume data 


¢ Disk Group—An object that represents a collection of LSM disks and 
subdisks for use by an LSM volume 


e Plex—An object that represents a subdisk or collection of subdisks to 
which LSM writes a copy of the volume data or log information 


¢ Volume—An object that represents a hierarchy of LSM objects, including 
LSM disks, subdisks, and plexes in a disk group. Applications and file 
systems make read and write requests to the LSM volume. 


The following sections describe LSM objects in more detail. 


1.1.1 LSM Disk 


An LSM disk is a Tru64 UNIX supported storage device, including disks, 
disk partitions, and RAID sets, that you configure exclusively for use by 
LSM.LSM views the storage in the same way as the Tru64 UNIX operating 
system software views it. For example, if the Tru64 UNIX operating system 
software considers a RAID set as a single storage device, so does LSM. See 
the Tru64 UNIX Software Product Description (SPD) for a list of supported 
storage devices. 


Figure 1-1 shows a typical hardware configuration that LSM supports. 
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Figure 1-1: Typical LSM Hardware Configuration 
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A storage device becomes an LSM disk when you initialize it for use by LSM. 
There are three types of LSM disks: 


¢ A sliced disk, which initializes an entire disk for LSM use. This type 
of initialization organizes the storage into two regions on separate 
partitions—a large public region used for storing data and a private 
region for storing LSM internal metadata, such as LSM configuration 
information. The default size of the private region is 4096 blocks. 
Figure 1-2 shows a sliced disk: 
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Figure 1-2: LSM Sliced Disk 
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¢« A simple disk, which initializes a disk partition. This type of 
initialization organizes the storage into two regions on the same 
partition—a large public region used for storing data and a private 
region for storing LSM internal metadata, such as LSM configuration 
information. The default size of the private region is 4096 blocks. 
Figure 1-3 shows a simple disk: 


Figure 1-3: LSM Simple Disk 
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Whenever possible, initialize the entire disk as a sliced disk instead of 
configuring individual disk partitions as simple disks. This ensures that 
the disk’s storage is used efficiently and avoids using space for multiple 
private regions on the same disk. 


¢ A nopriv disk, which initializes a disk partition that contains data you 
want to encapsulate. This type of initialization creates only a public 
region for the data and no private region. Figure 1-4 shows a nopriv disk: 


Figure 1-4: LSM Nopriv Disk 
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1.1.2 Disk Group 


A disk group is an object that represents a grouping of LSM disks. LSM 
disks in a disk group share a common configuration database that identifies 
all the LSM objects in the disk group. LSM automatically creates and 
maintains copies of the configuration database in the private region of 
multiple LSM sliced or simple disks in each disk group. 


LSM distributes these copies across all controllers for redundancy. If LSM 
disks in a disk group are located on the same controller, LSM distributes the 
copies across several disks. LSM automatically records changes to the LSM 
configuration and, if necessary, changes the number and location of copies of 
the configuration database for a disk group. 


You cannot have a disk group of only LSM nopriv disks, because an LSM 
nopriv disk does not have a private region to store copies of the configuration 
database. 


You must create an LSM volume within a disk group, and volumes cannot 
use disks from more than one disk group. By default, the LSM software 
creates a default disk group called rootdg. You can create all of your volumes 
in the rootdg disk group or you can create other disk groups. For example, if 
you dedicate disks to store financial data, you can create and assign those 
disks to a disk group called finance. 


When you add an LSM disk toa disk group, LSM assigns it a disk media 
name. By default, the disk media name is the same as the disk access 
name, which the operating system software assigns to a storage device. For 
example, the disk media name and disk access name might be dsk1. 


You do not have to use the default disk media name. You can assign a disk 
media name of up to 31 alphanumeric characters that cannot include spaces 
or the forward slash (/). For example, you could assign a disk media name 
of finance_data_disk. 


LSM associates the disk media name with the operating system's disk access 
name. The disk media name provides insulation from operating system 
naming conventions. This allows LSM to find the device should you move it 
to a new location (for example, connect a disk toa different controller). 


1.1.3 Subdisk 


A subdisk is an object that represents a contiguous set of blocks in an LSM 
disk’s public region that LSM uses to store data. 


By default, LSM assigns a subdisk name using the LSM disk media name 
followed by a dash (-) and an ascending two-digit number beginning with 
01. For example, dsk1-01 is the subdisk name on an LSM disk with a disk 
media name of dsk1. 
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You do not have to use the default subdisk name. You can assign a subdisk 
name of up to 31 alphanumeric characters that cannot include spaces or the 
forward slash (/ ). For example, you could assign a subdisk media name of 
finance_diskOl1. 


A subdisk can be: 


¢« The entire public region. The following figure shows that the entire 
public region of an LSM disk was configured as a subdisk called dsk1-01: 
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¢ A portion of the public region. The following figure shows a public region 
of an LSM disk was configured as two subdisks called dsk2-01 and 
dsk2-02: 
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1.1.4 Plex 


A plex is an object that represents a subdisk or collection of subdisks in 
the same disk group to which LSM writes a copy of volume data or log 
information. There are three types of plexes: 


¢ Data plex 


A data plex contains volume data. There are three types of data plexes. 
The data plex that you choose depends on how you want LSM to store 
volume data on subdisks. The following lists the three types of data 
plexes: 


- Concatenated data plex 


In a concatenated data plex, LSM writes volume data in a linear 
manner. 
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- Striped data plex 
In a striped data plex, LSM separates and writes volume data in 
a striped manner. 
- RAID 5 data plex 
In a RAID 5 data plex, LSM separates and writes volume data in a 
striped manner with parity. 
e Log plex 


A log plex contains information about activity in a volume. In the event 
of a failure, LSM recovers only those areas of the volume identified in 
the log plex. There are two types of log plexes: 


- Dirty Region Log (DRL) plex 
In aDRL plex, LSM logs regions in a mirrored concatenated or 
striped data plex. 

- RAID 5log plex 


In aRAID 5 log plex, LSM logs blocks being changed ina RAID 5 data 
plex and stores a temporary copy of the data and parity being written. 


¢ Data and log plexes (for compatibility with LSM Version 4.0) 


By default, LSM assigns a plex name using the volume name followed by a 
dash (-) and an ascending two-digit number beginning with 01. For example, 
volumel-01 is the name of a plex for a volume called volumel. 


You do not have to use the default plex name. You can assign a plex name 
of up to 31 alphanumeric characters that cannot include spaces or the 
forward slash (/). For example, you could assign a plex media name of 
finance_plex01. 


1.1.4.1 Concatenated Data Plex 


In a concatenated data plex, LSM creates a contiguous address space on the 
subdisks and sequentially writes volume data in a linear manner. If LSM 
reaches the end of a subdisk while writing data, it continues to write data to 
the next subdisk as shown in Figure 1-5. 
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Figure 1-5: Concatenated Data Plex 
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A single subdisk failure in a concatenated data plex will result in LSM 
volume failure. To prevent this type of failure, you can create multiple 
mirror (duplicate) plexes on different subdisks. LSM continuously maintains 
the data in the mirrors. If a plex becomes unavailable because of a subdisk 
failure, the volume continues operating using a mirror plex. 


Using subdisks on different SCSI buses for mirror plexes speeds read 
requests, because data can be simultaneously read from multiple plexes. 


LSM creates a DRL plex when you mirror plexes. A DRL plex divides the 
data plexes into a set of consecutive regions and tracks regions that change 
due tol/O writes. When the system restarts after a failure, only the changed 
regions are recovered. 


If you do not use a DRL plex and the system restarts after a failure, LSM 
must copy and resynchronize all of the data to each plex to restore the 
plex consistency. Although this process occurs in the background and the 
volume is still available, it can be a lengthy procedure and can result in 
unnecessarily recovering data. 


You can create up to 32 plexes, which can be any combination of data or DRL 
plexes. Mirror plexes consume more disk space than other types of plexes, 
because there is a DRL plex and because volume data is written to each plex. 
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Figure 1-6 shows a concatenated plex with one mirror. 


Figure 1-6: Concatenated Data Plex with One Mirror 
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1.1.4.2 Striped Data Plex 


In a striped data plex, LSM separates the data into units of equal size 

(64 KB by default) and writes the data units on two or more columns of 
subdisks, creating a stripe of data on the columns. LSM can simultaneously 
write the data units if there are two or more units and the subdisks are on 
different SCSI buses. 


Figure 1-7 shows how a write request of 384 KB of data is separated into six 
64 KB units and written to three columns as two complete stripes. 
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Figure 1-7: Writing Data to a Striped Plex 
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If a write request does not complete a stripe, then the first data unit of the 
next write request starts in the next column. For example, Figure 1-8 
shows how 320 KB of data is separated into five 64 KB units and written 
to three columns. The first data unit of the next write request will start 
in the third column. 
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Figure 1-8: Incomplete Striped Data Plex 
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As ina concatenated data plex, a single subdisk failurein a striped data plex 
will result in volume failure. To prevent this type of failure, you can create 
multiple mirror (duplicate) plexes on different subdisks. LSM continuously 
maintains the data in the mirrors. If a plex becomes unavailable because of 
a subdisk failure, the volume continues operating using a mirror plex. 


Using subdisks on different SCSI buses for mirror plexes speeds read 
requests, because data can be simultaneously read from multiple plexes. 


LSM creates a DRL plex when you mirror plexes. A DRL plex divides the 
data plexes into a set of consecutive regions and tracks regions that change 
due tol/O writes. When the system restarts after a failure, only the changed 
regions are recovered. 


If you do not use a DRL plex and the system restarts after a failure, LSM 
must copy and resynchronize all of the data to each plex. Although this 
process occurs in the background and the volume is still available, it can bea 
lengthy procedure and can result in unnecessarily recovering data. 


You can create up to 32 plexes, which can be any combination of data or DRL 
plexes. Mirror plexes consume more disk space than other types of plexes, 
because there is a DRL plex and because volume data is written to each plex. 


Figure 1-9 shows a striped data plex with one mirror. 
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Figure 1-9: Striped Data Plex with One Mirror 
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1.1.4.3 RAID 5 Data Plex 


In a RAID 5 data plex, LSM calculates a parity value for each stripe of 
data, then separates the stripe of data and parity into units of equal size 
(16 KB by default) and writes the data and parity units on three or more 
columns of subdisks, creating a stripe of data across the columns. LSM can 
simultaneously write the data units if there are three or more units and the 
subdisks are on different SCSI buses. If a subdisk in a column fails, LSM 
continues operating using the data and parity information in the remaining 
columns to reconstruct the missing data. 


In a RAID 5 data plex, LSM writes both data and parity across columns, 
writing the parity in a different column for each stripe of data. The first 
parity unit is located in the last column. Each successive parity unit is 
located in the next column, left-shifted one column from the previous parity 
unit location. If there are more stripes than columns, the parity unit 
placement begins again in the last column. 


Figure 1-10 shows how data and parity information are written ina RAID 5 
data plex with three columns. 
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Figure 1-10: Data and Parity Placement in a Three-Column RAID 5 Data 
Plex 
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In Figure 1-10, the first stripe of data contains data units 1 and 2 and parity 
unit PO. The second stripe contains data units 3 and 4 and parity unit P1. 
The third stripe contains units 5 and 6 and parity unit P2. 


By default, creating a RAID 5 data plex creates a RAID 5 log plex. A RAID 
5 log plex keeps track of data and parity blocks being changed due to I/O 
writes. When the system restarts after a failure, the write operations that 
did not complete before the failure are restarted. 
Note 
You cannot mirror a RAID 5 data plex. 


The TruCluster software does not support RAID 5 data plexes. 


1.1.5 LSM Volumes 


A volume is an object that represents a hierarchy of plexes, subdisks, and 
LSM disks. Applications and file systems make read and write requests to 
the LSM volume. The LSM volume depends on the underlying LSM objects 
to satisfy the request. 


An LSM volume can use storage from only one disk group. 
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As with all storage devices, an LSM volume has a block device interface and 
a character device interface. 


¢ A volume's block device interface is located in the /dev/vol/diskgroup 
directory. 


e A volume's character device interface is located in the 
/dev/rvol/diskgroup/volume directory. 


Because these interfaces support the standard UNIX open, close, read, 
write, and ioctl calls, databases, file systems, applications, and secondary 
swap use an LSM volumein the same manner as a disk partition as shown 
in Figure 1-11. 


Figure 1-11: Using LSM Volumes Like Disk Partitions 


Block/Character 
Device Interface 


open ("/dev/rvol/rootdg/vol01", O_RDWR) 


newfs /dev/rvol/dg1/vol02 
mount /dev/vol/dg1/vol02 /mnt 


Secondary 
Swap : 


1 
swapon /dev/vol/rootdg/vol04 
l 


ZK-1011U-Al 


1.2 LSM Interfaces 


You create, display, and manage LSM objects using any of the following 
interfaces: 
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¢« AJ ava-based graphical user interface (GUI) called LSM Storage 
Administrator that displays a hierarchical view of LSM objects and 
their relationships. 


The Storage Administrator provides dialog boxes in which you enter 
information to create or manage LSM objects. Completing a dialog box 
can be the equivalent of entering several command-line commands. The 
Storage Administrator allows you to manage local or remote systems on 
which LSM is running. You need an LSM license to use the Storage 
Administrator. See Appendix A for more information on using the 
Storage Administrator. 


¢ A menu-based, interactive interface called voldiskadm. 


To perform a procedure, you choose an operation from the main menu 
and the voldiskadm interface prompts you for information. The 
voldiskadm interface provides default values when possible. You can 
press Return to use the default value or enter a new value or enter ? at 
any time to view online help. See Appendix C and the voldiskadm(8) 
reference page for more information. 


¢ A bit-mapped GUI called Visual Administrator. 


The Visual Administrator allows you to view and manage disks and 
volumes and perform limited file system administration. The Visual 
Administrator displays windows in which LSM objects are represented 
as icons. This GUI requires a bit-mapped display, the Basic X 
Environment software subset, and an LSM license. See Appendix D for 
more information on the Visual Administrator. 


¢ LSM commands that you enter at the system prompt. The examples 
in this guide use LSM commands. 


You can use the LSM interfaces interchangeably. That is, LSM objects 
created by one interface are manageable through and compatible with LSM 
objects created by other LSM interfaces. 


1.2.1 LSM Command Interface 


LSM provides a range of commands that allow you to display and manage 
LSM objects. 


Table 1-1 lists the LSM commands and their functions. 


Table 1-1: LSM Commands 


Command Function 
volsetup Initialize the LSM software 
volencap Encapsulate disks or disk partitions 
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Table 1-1: LSM Commands (cont.) 


Command Function 

volreconfig Create LSM volumes from the encapsulated disks 
volrootmir Mirror the root and swap volumes 

voldiskadd Interactively create LSM disks 

voldisksetup Add one or more disks for use with LSM (with -i option) 
volassist Create, mirror, back up, and move volumes automatically 
voldisk Administer LSM disks 

voldg Administer disk groups 

vol plex Administer plexes 

volume Administer volumes 

volsd Administer subdisks 

vol make Create LSM objects manually 

vol mirror Mirror a plex 

voledit Create, modify, and remove LSM records 

volprint Display LSM configuration information 

volsave Back up the LSM configuration database 

volrestore Restore the LSM configuration database 

vol mend Mend simple problems in configuration records 

vol notify Display LSM configuration events 

vol watch Monitor LSM for failure events and perform hot-sparing if enabled 
volstat Display LSM statistics 

vol dctl Control daemon operations 

voltrace Trace I/O operations on volumes 

volevac Evacuate all volume data from a disk 

vol recover Synchronize plexes after a crash or disk failure 
volinstall Customize the LSM environment 

voldiskadm Start the interactive menu interface 

Ismsa Start the LSM Storage Administrator GUI 


For more information on a command, see the reference page corresponding 
toits name. For example, for more information on the volassist command, 
enter: 


# man volassist 
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Planning LSM Volumes and Disk Groups 


Planning your LSM configuration includes deciding: 

¢ How many disk groups you need, and which disks you will configure 
in a disk group 

« How many volumes you want, and the type of data plex the volumes 
will use 


This chapter provides information and worksheets to assist you in planning 
LSM disk groups and volumes. You might want to make copies of the blank 
worksheets for future use. 


2.1 Planning LSM Volumes 
Planning LSM volumes includes deciding what attributes you want the LSM 
volumes to have. An LSM volume has two types of attributes: 
e Attributes for which you must provide a value, as described in Table 2-1. 


e Attributes that are assigned a default value, which you can change, 
as described in Table 2-2. 


Table 2-1: LSM Volume Attributes with No Default Values 
Attribute Notes 


Volume name Can be 31 alphanumeric characters but cannot 
include a space or slash (/). 
Must be unique in the disk group where you create 
the volume. 


Volume size or length The total amount of space that the LSM volume 
will usein the disk group. Include space for mirror 
plexes and log plexes. 

You can specify volume size in sectors (the default), 
kilobytes, megabytes, gigabytes, or terabytes. 
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Table 2—2: LSM Volume Attributes with Default Values 


Attribute Notes and Default Value 


Number of data plexes Volumes that use a RAID 5 plex always have only one 
data plex. (RAID 5 plexes cannot be mirrored.) 
Volumes that use concatenated or striped plexes can 
have up to 32 plexes. 
Default: One data plex, no log plex 


Log plex size For volumes less than or equal to 1 GB that use mirror 
plexes (striped or concatenated), the DRL is 65 blocks 
to allow for migration toa TruCluster environment. 
The minimum DRL size is approximately 2 blocks 
per GB of volume size. You can use the minimum if 
you know the LSM configuration will not be used in 
a cluster. 

For volumes that use a RAID 5 plex, the log plex is [10 
* (number of columns * data unit size)]. 


Plex type A plex type is either concatenated, striped, or RAID 5. 
You can mirror concatenated or striped plexes. 
Default: Concatenated, no mirror 
See Table 2-3 for information on choosing a plex type. 


Name of the disk group A volume can be in only one disk group 

where you will create Default: rootdg disk group 

the volume 

LSM disks that the volume If the volume has a striped or RAID 5 plex, each 
will use column must be on different disks of equal size, 


preferably on different buses. 


If the volume has mirror plexes, create data plexes on 
disks of equal size on different buses, and create the 
DRL plex on a disk that is not used for a data plex. 


Default: LSM chooses the disks 


Usage type of the volume Use fsgen for volumes that use concatenated or 
striped plexes and contain a file system. 


Use gen for volumes that use concatenated or striped 
plexes and contain data other than a file system. 


Use raids for volumes that use a RAID 5 plex 
regardless of the contents of the volume. 


Default: fsgen 
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Table 2-3: Choosing a Plex Type 


Plex Type Benefits Tradeoffs 

Concatenated Allows you to use space on Possible uneven performance (hot 
multiple disks that might spots, one disk in use by multiple 
otherwise be wasted. applications). 
Concatenated plex can be When mirrored, requires at least 


mirrored for data redundancy. twice as much disk space (up to 
32 times, depending on number 


of plexes). 
Striped Allows you to distribute data When mirrored, requires at 
and therefore I/O load evenly _ least twice as many disks (up 
across many disks. to 32 times as many, depending 


Striped plex can be mirrored on number of plexes). 


for data redundancy and high 
availability. 


RAID 5 Provides redundancy through Depending on the !/O stripe size, 
parity, using fewer disks than performance might be slower 
a volume with striped mirror than avolumewith striped plexes 
plexes. due to parity calculation. 


Provides the I/O distribution 
benefit of striping. 


The following sections provide worksheets to assist you in planning 
LSM volumes depending on the type of plex you want to use. Using the 
information in these worksheets will help you when you create volumes 
as described in Chapter 4. 
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2.1.1 Planning an LSM Volume That Uses a Concatenated Plex 


Use the following worksheet to plan an LSM volume that uses a concatenated 
plex. 


Figure 2-1: Worksheet for Planning a Volume with Concatenated Plexes 


Attribute Default Values Chosen Values 
Volume name No default 
Volume size No default 


Number of data plexes 1 


If more than one plex, 65 blocks for volumes less 


DRL plex size than or equal to 1 GB? 
Disk group name rootdg 

Usage type fsgen 

Total volume size Volume size * number of 


plexes +DRL size 


@ For usein acluster. Minimum DRL for standalone system is approximately 2 blocks per GB of volume size. 
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2.1.2 Planning an LSM Volume That Uses a Striped Plex 


Use the following worksheet to plan an LSM volume that uses a striped plex. 


Figure 2-2: Worksheet for Planning a Volume with Striped Plexes 


Attribute Default Values Chosen Values 
Volume name No default 

Volume size No default 

Data unit size 64 KB 

Number of columns Minimum of two, based 


on number of disks in disk 
group and the volume size 


Number of data plexes 1 


If morethan one plex, 65 blocks for volumes less 


DRL plex size than or equal to 1 GB? 
Disk group name rootdg 

Usage type fsgen 

Total volume size Volume size * number of 


plexes +DRL size 


9 For usein acluster. Minimum DRL for standalone system is approximately 2 blocks per GB of volume size. 
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2.1.3 Planning an LSM Volume That Uses a RAID 5 Plex 


Use the following worksheet to plan an LSM volume that uses a RAID 5 plex. 


Figure 2-3: Worksheet for Planning a Volume with a RAID 5 Plex 


Attribute Default Values Chosen Values 
Volume name No default 

Volume size No default 

Data unit size 16 KB 

Number of columns Between 3 and 8 based on | (Minimum of three) 


number if disks in disk 
group and the volumesize 


Log plex size 10 * (data unit size * 
number of columns) 
Disk group name rootdg 
Usage type Must be raid5 raids 
Total volume size Volume size +log plex size 


2-6 Planning LSM Volumes and Disk Groups 


2.2 Planning Disk Groups 


At a minimum, you must plan the rootdg disk group, which is created when 
you install LSM. Planning a disk group requires that you identify: 


How much space a disk group requires by identifying the size of volumes 
that you will create in the disk group, as identified in Section 2.1. 


Unused storage devices to meet the space requirement of the disk group, 
as identified in Section 2.3. 


When you plan a disk group, consider the following: 


You must identify at least one unused storage device for the rootdg disk 
group when you install LSM. 


A disk group should have more than one storage device to ensure that 
there are multiple copies of the disk group’s configuration database. 


A disk group should have storage devices on different buses because LSM 
can simultaneously read and write data for volumes that use mirrored or 
striped plexes or a RAID 5 plex. 


Use the worksheets in Figure 2-4 and Figure 2-5 to plan disk groups. You 
can make copies and fill in the information there, rather than in the guide. 
This lets you keep the disk group information with each system running 
LSM, like a quick reference guide. 


In the worksheets, enter the following: 


Under Disk Group Information, include any information that will 
help you keep track of the purpose of that disk group. For example, you 
might create a disk group called finance whose purpose is to contain one 
or more volumes that will be used by a financial application. You might 
create another disk group called oracle, which will contain a volume 
used by an Oracle database. 


Under Volume, Plex and Spare Disk Information, include the 
names of all volumes in that disk group, their plex type, which disks 
belong to which plex, and identify any spare disks that will be used to 
replace failed disks, if you enabled the hot-spare option to the volwatch 
daemon. Figure 2-6 is an example of a completed worksheet. 
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Figure 2—4: Worksheet for Planning rootdg Disk Group 


Disk Group Disks in Bus/LUN Disk Size | Volume, Plex and Spare 
Information Group Number Disk Information 
Name: 
rootdg 
Purpose: 
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Figure 2-5: Worksheet for Planning Additional Disk Groups 


Disk Group Disks in Bus/LUN Disk Size | Volume, Plex and Spare 
Information Group Number Disk Information 


Name: 
Purpose: 
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Figure 2-6 shows a combined example of what your disk group planning 
worksheets might look like when complete. 


Figure 2-6: Worksheet for Planning Disk Groups (Completed Example) 


Disk Group Disks in Bus/LUN' Disk Volume, Plex and Spare 
Information Group Number Size Disk Information 
Name: rootdg dskO 0 1MB _ root disk (encapsulated: 
Purpose: root file rootvol plex-01) 
7 and boot dsk1 0) 1GB_ rootvol plex-02 
isks, 
dsk4 2 1GB_— swapvol plex-01 
dsk5 2 1GB_— swapvol plex-02 
dsk16 6 1GB _ hot-spare disk 
Name: oracle_dg dsk6 3 1GB_ volume: ord_vol 
Purpose: Oracle plex: ord_vol-01 
database, must be ; 
peduadant: dsk7 3 1GB plex: orcdl_vol-01 
Contains volumewith dsk8 4 1GB plex: ord_vol-02 
ah Pine ane dsk9 4 1GB plex: ord_vol-02 
dsk10 5 1GB_ plex: ord_vol-03 (DRL plex) 
dsk11 5 1GB _ hot-spare disk 
dsk15 6 1GB _ hot-spare disk 
Name: finance_dg dsk20 7 500 MB_ volume: fin_vol 
Purpose: financial column: 1 
application, must be 
highly available. dsk25 8 500 MB_ column 2 
Contains volume dsk30 9 500 MB_ column 3 
Lees ies dsk35 10 500MB_ column 4 
plex (read-only 
application). dsk40 11 500 MB_ column 5 
dsk45 16 500 MB _ log plex 
dsk16 6 500 MB _hot-spare disk 


2.3 Identifying Unused Storage Devices 


Unused storage devices are unused disks, partitions, and RAID disks that 
LSM can initialize to become LSM disks for exclusive use in the rootdg disk 
group or in the other disk groups that you create. 


You can also identify unused LSM disks for usein a disk group. An unused 
LSM disk is a storage device that you initialized for use by LSM but did 
not assign to a disk group. 
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The following sections describe how to identify unused disks, partitions, and 
LSM disks. See your RAID documentation for information on identifying 
unused RAID disks. 


To identify unused storage devices, you can use: 

¢ The Disk Configuration Graphical User Interface (GU!) 

¢ The command-line interface of operating system utilities 

¢ Thevoldisk list command ona system where LSM is running 


2.3.1 Using the Disk Configuration GUI to Identify Unused Disks 
To identify unused disks using the Disk Configuration GUI, start the Disk 
Configuration interface using either of the following methods: 
¢« From the system prompt, enter: 
# /usr/sbin/diskconfig 
¢ FromtheSysMan Applications pop-up menu on the CDE Front Panel: 


1. Choose Configuration 
2. Doubleclick the Disk icon in the SysMan Configuration folder 
A window titled Disk Configuration on hostname is displayed. This is 


the main window for the Disk Configuration GUI, and lists the following 
information for each disk: 


- Thedisk name, such as dsk10 
- Thedevice model, such as RZ1CB-CA 
- Thebus number for the device 


For more information about a disk, double click on the list item (or 
click the Configure... button when a disk is highlighted). The Disk 
Configuration: Configure Partitions: window is displayed. This window 
contains: 


- A graphical representation of the disk partitions in a horizontal 
bar-chart format and disk information such as the disk name, the 
total size of the disk, and usage information. 


- A Partition Table button that you can click to display a bar chart of 
the current partitions in use, their sizes, and the file system in use. 


- A Disk Attributes button that you can click to display values for 
disk attributes. 


For moreinformation about the Disk Configuration GUI, see the online help. 
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2.3.2 Using Operating System Commands to Identify Unused Disks 


You can use the operating system's hwmgr and disklabel commands to 
identify unused disks by following these steps: 


1. Usethe following command to display disk and bus information: 
# hwmgr -view dev 


Information similar to the following is displayed: 


HWID: DSF Name Mfg Model Location 
3: /dev/kevm 
22: /dev/disk/dsk0c DEC RZ26 bus-0-targ-3-lun-0 
23: /dev/disk/cdrom0c DEC RRD42 bus-0-targ-4-lun-0 
24: /dev/disk/dsklc DEC RZ26L bus-1-targ-2-lun-0 
25: /dev/disk/dsk14c DEC RZ26L bus-1-targ-4-lun-0 
29: /dev/ntape/tapeO DEC TLZ06 bus-1-targ-6-lun-0 
35: /dev/disk/dsk8c COMPAQ RZ1CF-CF bus-2-targ-12-lun-0 
2. Toverify if adisk or partition is unused, choose a disk from the previous 
output and enter the disklabel command with the name of the disk; 


for example: 
# disklabel dsk14 
Disk partition information similar to the following is displayed: 


# /dev/rdisk/dskl4c: 


co: 


partitions: 
# size offset fstype [fsize bsize cpg] # NOTE: values not exact 

a: 131072 (0) unused 0 0 # (Cyl. 0 - 95*) 

b: 262144 131072 unused 0 0 # (Cyl. 95*- 285*) 

fons 4110480 (0) unused 0 0 # (Cyl. 0 - 2987*) 

d: 0 0 unused (0) (0) # (Cyl. 0 - -1) 

e: 0 0 unused (0) (0) # (Cyl. 0 - -1) 

£: 0 0 unused (0) (0) # (Cyl. 0 - -1) 

g: 1858632 393216 unused 0) 0) # (Cyl. 285*- 1636*) 

h: 1858632 2251848 unused 0) 0) # (Cyl. 1636*- 2987*) 


See the disklabel(8) reference page for more information on the 
disklabel command. 


2.3.3 Using the voldisk Command to Identify Unused Disks 


When LSM starts, it obtains a list of disk device addresses from the 
operating system software and checks the disk labels to determine which 
devices are initialized for LSM use and which are not. 


You can usethe voldisk command to display a list of all known disks and to 
display detail information about a particular disk: 


¢ Toview a list of disks, enter: 


# voldisk list 
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Information similar to the following is displayed. 


DEVICE 
dsko 
dsk1 
dsk2 
dsk3 
dsk4 
dsk5 
dské 
dsk7 
dsk8 
dsk9 
dsk10 
dsk11 
dsk12 
dsk13 
dsk14 


TYPE DISK GROUP STATUS 
sliced - - unknown 
sliced - - unknown 
sliced dsk2 rootdg online 
sliced dsk3 rootdg online 
sliced dsk4 rootdg online 
sliced dsk5 rootdg online 
sliced dské dg1 online 
sliced - - online 
sliced dsk8 dg1 online 
sliced - - online 
sliced - - online 
sliced - - online 
sliced - - online 
sliced - - unknown 
sliced - - unknown 


The following list describes the information in the output: 


DEVICE 


TYP] 


GI 


DISK 


GROUP 


STATUS 


Specifies the disk access name assigned by the 
operating system. 


Specifies the LSM disk type (sliced, simple, or nopriv). 


Specifies the LSM disk media name. A dash (-) means the 
device was not initialized for LSM use and therefore does not 
have an LSM disk media name. 


Specifies the disk group to which the device belongs. A dash 
(-) means the device was not initialized for LSM use and 
therefore the device is not in a disk group. 


An unused storage device is one that does not have a DISK 
name or GROUP name, and has a status of unknown. 

An unused LSM disk is one that has a DISK name, but no 
GROUP name and a status of online or offline. 


To display detail information about an LSM disk, enter: 


# voldisk list disk 


The following example displays information for an LSM disk called dsk5: 


Device: 


devicetag: 


type: 
hostid: 
disk: 
group: 
flags: 
pubpaths: 


privpaths: 


version: 
iosize: 
public: 
private: 
update: 
headers: 
configs: 


dsk5 
dsk5 
sliced 


servername 

name=dsk5 id=942260116.1188.servername 
name=dgl1 id=951155418.1233.servername 
online ready autoimport imported 
block=/dev/disk/dsk5g char=/dev/rdisk/dsk5g 
block=/dev/disk/dsk5h char=/dev/rdisk/dsk5h 


n.n 


min=512 


(bytes) max=2048 (blocks) 


slice=6 offset=16 len=2046748 
slice=7 offset=0 len=4096 
time=952956192 seqno=0.11 


0 248 


count=1 len=2993 
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logs: count=1 len=453 


Defined regions: 
config priv 17- 247[ 231]: copy=01 offset=000000 enabled 


priv 249- 3010[ 2762]: copy=01 offset=000231 enabled 


config 
3463[ 453]: copy=01 offset=000000 enabled 


log priv 3011- 


The size of an LSM disk is displayed in blocks as the len= valuein the 
public: row. 2048 blocks equal 1 MB. 


See the voldisk(8) reference page for more information on the voldisk 
command. 
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Installing or Upgrading the LSM Software 


This chapter describes how to: 


¢ Preparean existing LSM configuration on a system running Tru64 UNIX 
Version 4.0 or higher for reuse when the system is upgraded to Tru64 
UNIX Version 5.1 or higher (Section 3.1), which includes: 


- Increasing the size of BCLs 
- Deporting disk groups that you do not want to upgrade 
- Backing up the current LSM configuration 
¢ Install or upgrade the LSM software (Section 3.2) 
e Install the LSM license (Section 3.3), which is necessary to: 
- Create volumes with striped or RAID 5 plexes 
- Create volumes with mirror plexes 
- Usethe other LSM interfaces 
¢ Perform the following optional LSM postinstallation tasks: 
- Initialize the LSM software (Section 3.4.1) 
- Optimize the configuration database (Section 3.4.2) 
- Createan alternate boot disk (Section 3.4.3) 
- Configure the LSM hot-sparing feature (Section 3.4) 


3.1 Preparing to Upgrade LSM 


If you are currently using LSM on a system running Tru64 UNIX Version 
4.0D or higher and you want to preserve your current LSM configuration for 
use with Tru64 UNIX Version 5.0 or higher, you must: 


¢ Increase the size of any block-change logs (BCLs) to at least two blocks 
¢ Optionally, deport any disk groups that you do not want to upgrade 
¢ Back up the current LSM configuration 


3.1.1 Increasing the Size of BCLs 


The dirty-region logging (DRL) feature is a replacement for the block-change 
logging (BCL) feature that was supported in Tru64 UNIX Version 4.0D. This 
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section applies only if you are upgrading a system with an existing LSM 
configuration from Tru64 UNIX Version 4.0D to Version 5.0 or higher. 


When you perform an upgrade installation, BCLs are automatically 
converted to DRLs if the BCL subdisk is at least two blocks. If the BCL 
subdisk is one block, logging is disabled after the upgrade installation. 


Before you upgrade, increase the size of the BCLs to at least two blocks (for 
standalone systems) or 65 blocks (for a TruCluster environment). If this is 
not possible, then after the upgrade you can enable DRL in those volumes 
with the volassist addlog command (Section 5.5.3). Thevolassist 
addlog command creates a DRL of at least 65 blocks by default. 


3.1.2 Deporting Disk Groups 


LSM Version 5.1 or higher has an internal metadata format that is not 
compatible with the metadata format of LSM Version 4.0D. If LSM detects 
an older metadata format during the upgrade procedure, LSM automatically 
upgrades the old format to the new format. If you do not want certain disk 
groups to be upgraded, you must deport them before you upgrade LSM. 


To deport a disk group, enter: 
# voldg deport disk group ... 


If you later import a deported disk group, LSM upgrades the metadata 
format. 


3.1.3 Backing Up a Previous LSM Configuration 
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Backing up the LSM configuration creates a file that describes all the LSM 
objects in all disk groups. In case of a catastrophic failure, LSM can use 
this file to restore the LSM configuration. You might also want to back 

up the volume data before performing the upgrade. See Section 5.4.2 for 
information on backing up volumes. 


To back up an LSM configuration: 


1. Start the backup procedure: 
# volsave [-d dir] 
Information similar to the following is displayed: 


LSM configuration being saved to /usr/var/lsm/db/LSM.date.LSM_hostidname 
LSM Configuration saved successfully to /usr/var/lsm/db/LSM.date.LSM_hostidname 


By default, LSM configuration information is saved to a time-stamped 
file called a description set in the /usr/var/1sm/db directory. In the 
previous example, date is the current date and LsmM_hostidname is, 

by default, the host name. Make a note of the location and name of the 
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file. You will need this information to restore the LSM configuration 
after you upgrade the LSM software and the Tru64 UNIX operating 
system software. 


2. Optionally, confirm that the LSM configuration was saved: 


# ls /usr/var/1sm/db/LSM.date.LSM hostidname 


Information similar to the following is displayed: 


header rootdg.d volboot voldisk.list 


3. SavetheLSM configuration to tape or other removable media. 


3.2 Installing or Upgrading LSM 


The LSM software resides in three optional subsets. These are located on 
the CD-ROM containing the base operating system software for the Tru64 
UNIX product kit. In the following list of subset names, nnn indicates the 
operating system version: 


e OSFLSMBINnnn 


Provides the kernel modules to build the kernel with LSM drivers. This 
software subset supports uniprocessor, SMP, and realtime configurations. 
This subset requires Standard Kernel Modules. 


¢ OSFLSMBASEnnn 


Contains the LSM administrative commands and tools required to 
manage LSM. This subset is mandatory if you install LSM during a 
Tru64 UNIX Full Installation. This subset requires LSM Kernel Build 
Modules. 


bd OSFLSMX11nnn 


Contains the LSM Motif-based graphical user interface (GUI) 
management tool and related utilities. This subset requires the Basic 
X Environment. 


You can install the LSM subsets either at the same time or after you install 
the mandatory operating system software. 


If you install the system's root file system and /usr, /var, and swap 
partitions directly into LSM volumes, the LSM subsets are installed 
automatically. 


See the Installation Guide for more information on installing and upgrading 
the LSM software and the operating system software. 
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Note 


If a file system was configured in an LSM volume, you must start 
LSM and its volumes after booting the system to single-user mode, 
before proceeding with the Tru64 UNIX upgrade installation. 


3.3 Installing the LSM License 


The LSM license that comes with the base operating system allows you to 
create LSM volumes that use a single concatenated plex. All other LSM 
features, such as creating LSM volumes that use striped, mirrored, and 
RAID 5 plexes and using the LSM GUIs, require an LSM license. 


TheLSM license is supplied in the form of a product authorization key (PAK) 
called LSM-OA. You load the LSM-oa PAK into the Tru64 UNIX License 
Management Facility (LMF). 


If you need to order an LSM license, contact your service representative. See 
the 1m£(8) reference page for more information on the License Management 
Facility. 


3.4 Performing Postinstallation Tasks 


After you install or upgrade LSM: 
¢ If applicable, initialize LSM. See Section 3.4.1 for more information. 


¢ Optionally, create an alternate boot disk. This converts the boot disk 
partitions toLSM volumes. See Section 3.4.3.2 for more information. 


¢ Optionally, enable the LSM hot-sparing feature. This directs LSM to 
transfer data (in a mirrored or RAID 5 plex) froma failed disk to a spare 
disk or to free disk space. See Section 3.4.4 for more information. 


e If you upgraded from Version 4.x of the operating system, you might 
want to modify the configuration database layout to take advantage of 
the automatic configuration database management in Version 5.x. See 
Section 3.4.2 for more information. 


3.4.1 Initializing LSM 


If you performed a full installation with the root file system and /usr, /var, 
and swap partitions installed directly into LSM volumes, or you performed 
an upgrade installation on a system that was previously running LSM, then 
LSM is automatically established. 


If you were running LSM previously and performed a full installation but 
did not install the root file system and /usr, /var, and swap partitions 
installed directly onto LSM volumes, then you must initialize LSM. 
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Initializing LSM: 


Creates the rootdg disk group. You should configure at least two unused 
disks or partitions in the rootdg disk group to ensure there are multiple 
copies of the LSM configuration database. You do not have to use the 
rootdg disk group for your volumes, but it must exist before you can 
create other disk groups. See Chapter 2 if you need help choosing disks 
or partitions for the rootdg disk group. 


If available, reestablishes an existing LSM configuration. 


Adds entries tothe /etc/inittab to automatically start LSM if the 
system boots. 


Creates the /etc/vol/volboot file, which contains LSM configuration 
information. 


Creates LSM files and directories. (See Section 3.4.1.2 for a description 
of these files and directories.) 


Starts the vold and voliod daemons. 


To initialize LSM: 


1. 


Verify that the LSM subsets are installed: 
# setld -i | grep LSM 


LSM subset information similar to the following should display, where 
nnn indicates the operating system revision: 

OSFLSMBASEnnn installed Logical Storage Manager (System Administration) 
OSFLSMBINnnn installed Logical Storage Manager Kernel Modules (Kernel 


Build Environment) 
OSFLSMX11nnn installed Logical Storage Manager GUI (System Administration) 


If the LSM subsets do not display with a status of installed, use the 
setld command to install them. See the Installation Guide for more 
information on installing software subsets. 


Verify LSM drivers are configured into the kerne!: 
# devswmgr -getnum driver=LSM 
LSM driver information similar to the following is displayed: 
Device switch reservation list 
(*sentry in use) 


driver name instance major 


Installing or Upgrading the LSM Software 3-5 


If LSM driver information is not displayed, you must rebuild the kernel 
using the doconfig command. See the Installation Guide for more 
information on rebuilding the kernal. 


3. Initialize LSM with the volsetup command. 
¢ Toreestablish an existing configuration, enter: 
# volsetup 


e If thereis no existing LSM configuration, specify at least two disks 
or partitions for LSM to use for the rootdg disk group: 


# volsetup {disk|partition} {disk|partition ...} 


For example, toinitialize LSM and use disks called dsk4 and dsk5 to 
create the rootdg disk group, enter: 


# volsetup dsk4 dsk5 


If you omit a disk or partition name, the volsetup Script prompts 
you for it. If the volsetup command displays an error message 
that the initialization failed, you might need to reinitialize the 
disk. See the Disk Configuration GUI for moreinformation about 
reinitializing a disk. 


You run the volsetup script only once. To add more disks to the 
rootdg disk group, use the voldiskadd command. See Section 5.2.2 for 
information on adding disks to a disk group. 


3.4.1.1 Verifying That LSM Is Initialized (Optional) 
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Normally, you do not need to verify that LSM was initialized. If the 
initialization fails, the system displays error messages indicating the 
problem. 


If you want to verify that LSM is initialized: 
e Verify that the disks were added to the rootdg disk group: 
# volprint 


Information similar to the following is displayed that shows dsk4 and 
dsk5 are part of the rootdg disk group: 


Disk group: rootdg 
TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTILO PUTILO 
dg rootdg rootdg - - - = = - 


dm dsk4 dsk4 = 1854536 = S S = 
dm dsk5 dsk5 = 1854536 = = - 7 


¢ Verify that the/etc/inittab file was modified to indudeLSM entries: 


# grep LSM /etc/inittab 
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Information similar to the following is displayed: 
lsmr:s:sysinit:/sbin/lsmbstartup -b /dev/console 2>&1 ##LSM 
lsm:23:wait:/sbin/lsmbstartup -n /dev/console 2>&1 ##LSM 
vol:23:wait:/sbin/vol-reconfig -n /dev/console 2>&1 ##LSM 


¢ Verify that the /etc/vol/volboot file was created: 


# /sbin/voldctl list 
Information similar to the following is displayed: 
Volboot file 
version: 3/1 
seqno: 0.4 
hostid: test.abc.xyz.com 
entries: 
e Verify that the vold daemon is enabled: 
# voldctl mode 
Information similar to the following is displayed: 
mode: enabled 
¢ Verify that two or more voliod daemons are running: 
# voliod 
Information similar to the following is displayed: 


2 volume I/O daemons are running 


There should be one daemon for each CPU in the system or a minimum 
of two. If the output shows only one daemon running, enter the following 
command, where n is the number of daemons to set: 


# voliod set n 
3.4.1.2 LSM Files, Directories, Drivers, and Daemons 
After you install and initialize LSM, several new files, directories, drivers, 


and daemons are present on the system. These are described in following 
sections. 


3.4.1.2.1_ LSM Files 


The /dev directory contains the device special files (Table 3-1) that LSM 
uses to communicate with the kernel. 
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Table 3-1: LSM Device Special Files 


Device Special File Function 

/dev/volconfig Allows the vold daemon to make configuration 
requests to kernel 

/dev/volevent Used by the voliotrace command to view 
and collect events 

/dev/volinfo Used by the volprint command to collect 
LSM object status information 

/dev/voliod Provides an interface between the volume extended 


1/0 daemon (voliod) and the kernel 


3.4.1.2.2 LSM Directories 


The /etc/vol directory contains the volboot file and the subdirectories 
(Table 3-2) for LSM use. 


Table 3-2: LSM /etc/vol/ Subdirectories 


Directory Function 


reconfig.d Provides temporary storage during encapsulation 
of existing file systems. Instructions for the 
encapsulation process are created here and 
used during the reconfiguration. 


tempdb Used by the volume configuration daemon 
(vold) while creating the configuration 
database during startup and while updating 
configuration information. 


vold_diag Creates a socket portal for diagnostic commands 
to communicate with the vold daemon. 


vold_request Provides a socket portal for LSM commands to 
communicate with the vold daemon. 


The /dev directory contains the subdirectories (Table 3-3) for volume block 
and character devices. 


Table 3-3: LSM Block and Character Device Subdirectories 


Directory Contains 


/dev/rvol LSM raw volumes for the root disk group rootdg 
and for root and user disk groups. 


/dev/vol LSM block device volumes for the root disk group 
rootdg and directories for root and user disk groups. 


3-8 Installing or Upgrading the LSM Software 


3.4.1.2.3 LSM Device Drivers 


There are two LSM device drivers: 
* volspec—The volume special device driver. 


Communicates with the LSM device special files. This is not a loadable 
driver; it must be present at boot time. 


* voldev—The volume device driver. 


Communicates with LSM volumes. Provides an interface between LSM 
and the physical disks. 


3.4.1.2.4 LSM Daemons 


There are two LSM daemons: 


* vold—The Volume Configuration Daemon. This daemon is responsible 
for maintaining configurations of disks and disk groups. It also: 


- Takes requests from other utilities for configuration changes 
- Communicates change requests to the kernel 

- Modifies configuration information stored on disk 

- Initializes LSM when the system starts 


* voliod—The Volume Extended |/O Daemon. This daemon performs the 
functions of a utility and a daemon. As a utility, voliod: 


- Returns the number of running volume |/O daemons 

- Starts more daemons when necessary 

- Removes some daemons from service when they are no longer needed 
As a daemon, voliod: 

- Schedules I/O requests that must be retried 

- Schedules writes that requirelogging (for DRL and RAID 5 log plexes) 


3.4.2 Optimizing the LSM Configuration Databases (Optional) 
If you restored a previous (Version 4.x) LSM configuration on a system that 


you upgraded to Version 5.1, you can modify the configuration databases to 
allow LSM to automatically manage their number and placement. 


Note 


This procedure is an optimization and is not required. 
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In Version 4.x, you had to explicitly configure between four and eight disks 
per disk group to have enabled databases. In Version 5.x, all disks should 
be configured to contain copies of the database and LSM will automatically 
maintain the appropriate number of enabled copies. The distinction between 
enabled and disabled copies is as follows: 


¢« Disabled—The disk’s private region is configured to contain a copy of the 
configuration database, but this copy might be dormant (inactive). LSM 
enables them as needed; for example, when a disk with an enabled copy 
is removed or fails. 


¢ Enabled—The disk’s private region is configured to contain a copy of the 
configuration database, and this copy is active All LSM configuration 
changes are recorded in these copies of the configuration database as 
they occur. 


You should configure the private regions on all your LSM disks to contain 
one copy of the configuration database unless you have a specific reason for 
not doing so, such as: 


¢« Thedisk is very old or slow. 
¢« Thedisk is on a bus that is very heavily used. 


¢ The private region is too small (less than 4096 blocks) to contain a copy 
of the configuration database (such as disks that have been migrated 
from earlier releases of LSM, with much smaller private regions). 


¢« Thereis some other significant reason why you determine the disk 
should not contain a copy. 


Enabling the configuration database does not use additional space on the 
disk; it merely sets the number of enabled copies in the private region to 1. 


To set the number of configuration database copies to1, enter: 
# voldisk moddb disk nconfig=1 


Disk groups containing three or fewer disks should be configured so that 
each disk contains two copies of the configuration database to provide 
sufficient redundancy. This is especially important for systems with a small 
rootdg disk group and one or more larger secondary disk groups. 


To set the number of configuration database copies to 2, enter: 


# voldisk moddb disk nconfig=2 
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3.4.3 Creating an Alternate Boot Disk 


You can use LSM tocreate an alternate boot disk from which the system can 
boot if the primary boot disk fails. To do so, you must: 


1. 


Usethe LSM encapsulation procedure to configure each partition on the 
boot disk into an LSM volume that uses a concatenated plex. You must 
also encapsulate the swap space partition if it is not on the boot disk. 
Encapsulation converts each partition toan LSM volume. 


Add a mirror plex to the volume to create copies of the data in the boot 
disk partitions 


Note 


To facilitate recovery of environments that use LSM, you can 

use the bootable tape utility. This utility enables you to build a 
bootable standalone system kernel on magnetictape. The bootable 
tape preserves your local configuration and provides a basic set of 
the LSM commands you will use during restoration. Refer to the 
btcreate(8) reference page and the Systen Administration guide 
or the online help for the SysMan Menu boot _tape option. 


3.4.3.1 Restrictions 


The following restrictions apply when you create LSM volumes for boot 
disk partitions: 


The system cannot be part of a TruCluster cluster. 


You must create LSM volumes for the root file system and the primary 


swap space partition at the same time. They do not have to be on the 
same disk. 


TheLSM volumes are created in the rootdg disk group and have the 
following names: 


rootvol—Assigned to the volume created for the root file system. 
Do not change this name, move the rootvol volume out of the rootdg 
disk group, or change the assigned minor device number of 0. 


swapvol—Assigned to the volume created for the swap space 
partition. Do not change this name, move the swapvol volume out of 


the rootdg disk group, or change the assigned minor device number 
of 1. 


All other partitions are assigned an LSM volume name that matches 
the original partition name. 
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The partition tables for the boot disk (and swap disk, if the swap space 
partition is not on the boot disk) must have at least one unused partition 
for the LSM private region, which cannot be the a or c partitions. LSM 
requires only the partition-table entry; it does not need the disk space 
associated with the partition. 


You need a separate disk (preferable on a different bus) to create the 
mirror plexes. You should not create mirror plexes on the dame disk. By 
definition, creating a mirror plex copies the data onto a different disk 
for redundancy in case of primary disk failure. The disk you use for the 
mirror plexes: 


- Must not be under LSM control. 


- Must havea disk label with all partitions marked unused. See the 
disklabel(8) reference page for more information. 


- Must beas large as the partitions on the boot disk plus the size of the 
private region, which by default is 4096 blocks. 


If the swap space partition is not on the boot disk, you need an 
additional disk for the swap space mirror plex that meets the first 
two requirements and is as large as the swap space partition plus the 
size of the private region, which by default is 4096 blocks. 


See Section 2.3 if you need help choosing a disk to use for the mirror. 


3.4.3.2 Encapsulating Boot Disk Partitions 


Encapsulating the boot disk configures each partition on the boot disk in 
an LSM volume that uses concatenated plexes. The steps to encapsulate 
the boot disk partitions are the same whether you are using the UNIX File 
System (UF S) or the Advanced File System (AdvF S). The encapsulation 
process changes the following files: 


If you are using UFS, the /etc/fstab file is changed to use LSM 
volumes instead of disk partitions. 


If you are using AdvFS, the /etc/fdmns/* directory is updated to 
change domain directories that have disk partitions associated with 
the boot disk. 


The /etc/sysconfigtab file is changed to update the swapdevice 
entry to use LSM volumes and toset the lsm_rootdev_is_ volume 
entry to 1. 


The bootdef_dev environment variable is changed to reflect the 
alternate boot disk (volume). 
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Note 


The boot disk encapsulation procedure requires that you reboot 
the system. 


To encapsulate the boot disk: 


1. Login as root. 

2. Identify the name of the boot disk: 
# sizer -r 
Information similar to the following is displayed: 
dsko 


3. Identify the name of the disk on which the swap space partition is 
located: 


# Swapon -s 
Information similar to the following is displayed: 


Swap partition /dev/disk/dsk0b (default swap) : 


Allocated space: 20864 pages (163MB) 
In-use space: 234 pages ( 1%) 
Free space: 20630 pages ( 98%) 


Total swap allocation: 


Allocated space: 20864 pages (163.00MB) 
Reserved space: 7211 pages ( 34% 
In-use space: 234 pages ( 1%) 
Available space: 13653 pages ( 65% 


In the previous example, the swap space partition is located in the b 
partition on disk dskO. 
4. Encapsulate the boot disk and swap disk if the swap space partition is 
not on the boot disk: 
# volencap boot disk [swap disk] 
For example, if dskO is the name of the boot disk and the swap space 
partition is located in the b partition on dskO, enter: 
# volencap dsk0O 
Information similar to the following is displayed: 
Setting up encapsulation for dsko. 
- Creating simple disk dsk0d for config area (privlen=4096). 
- Creating nopriv disk dsk0a for rootvol. 
- Creating nopriv disk dsk0b for swapvol. 


- Creating nopriv disk dsk0g. 


The following disks are queued up for encapsulation or use by LSM: 
dsk0d dsk0a dsk0Ob dsk0g 


You must now run /sbin/volreconfig to perform actual encapsulations. 
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5. Optionally, send a warning to users alerting them of the impending 
system shutdown. 


6. Perform the actual encapsulation, and enter now when prompted to 
shut down the system: 
# volreconfig 
Information similar to the following is displayed: 
The system will need to be rebooted in order to continue with 
LSM volume encapsulation of: 
dsk0d dsk0a dsk0b dsk0g 
Would you like to either quit and defer encapsulation until later 


or commence system shutdown now? Enter either ‘quit’ or time to be 
used with the shutdown(8) command (e.g., quit, now, 1, 5): [quit] now 


The system shuts down, performs the encapsulation, and automatically 
reboots the system. 


3.4.3.3 Creating Mirror Plexes for Boot Disk Volumes 


After you encapsulate the boot disk, each partition is converted toan LSM 
volume with a single concatenated plex. There is still only one copy of the 
boot disk data. To complete the process of creating an alternate boot disk, 
you must add a mirror plex to each boot disk volume. Preferably, the disks 
for the mirror plexes should be on different buses than the disks that contain 
the original boot disk volumes. 


The following procedure does not add a log plex (DRL) to the root and swap 
volumes, nor should you add a log plex manually. When the system reboots 
after a failure, the system automatically recovers the rootvol volume by 
doing a complete resynchronization. Attaching a log plex degrades the 
rootvol write performance and provides no benefit in recovery time after 

a system failure. 


To create mirror plexes, do one of the following: 
e |f the swap space partition is on the boot disk, enter: 
# volrootmir -a boot mirror disk 
For example, to create the mirror plex on a disk called dsk3, enter: 
# volrootmir -a dsk3 
e |f the swap space partition is not on the boot disk, enter: 
# volrootmir -a swap=swap mirror disk boot mirror disk 


See the volrootmir(8) reference page for more information. 


3.4.3.4 Displaying Information for Boot Disk Volumes 


To display information for the boot disk and root file system volumes, enter: 
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# volprint -ht 


Information similar to the following is displayed: 


Disk group: rootdg 


DG NAME NCONFIG NLOG MINORS GROUP-ID 

DM NAME DEVICE TYPE PRIVLEN PUBLEN STATE 

V NAME USETYPE KSTATE STATE LENGTH READPOL PREFPLEX 

PL NAME VOLUME KSTATE STATE LENGTH LAYOUT NCOL/WID MODE 
SD NAME PLEX DISK DISKOFFS LENGTH [COL/]OFF DEVICE MODE 
dg rootdg default default 0 942157566.1026. hostname 

v_ rootvo root ENABLED ACTIVE 262144 ROUND - 

pl rootvol-01 rootvo ENABLED ACTIVE 262144 CONCAT - RW 
sd root01-01p rootvol-01 rootol 0 16 0 dsk0a ENA 
sd root01-01 rootvol-01 rootol 16 262128 16 dsk0a ENA 
pl rootvol-02 rootvo ENABLED ACTIVE 262144 CONCAT = RW 
sd root02-02p rootvol-02 rootd2 0 16 0) dsk3a ENA 
sd root02-02 rootvol-02 root02 16 262128 16 dsk3a ENA 
vo swapvo swap ENABLED ACTIVE 333824 ROUND - 

pl swapvol-01 swapvo ENABLED ACTIVE 333824 CONCAT = RW 
sd swap01-01 swapvol-01 swap01 0) 333824 0 dsk0b ENA 
pl swapvol-02 swapvo ENABLED ACTIVE 333824 CONCAT RW 
sd swap02-02 swapvol-02 swap02 0 333824 0) dsk3b ENA 
v vol-dsk0g fsgen ENABLED ACTIVE 1450796 SELECT ze 

pl vol-dsk0g-01 vol-dsk0g ENABLED ACTIVE 1450796 CONCAT - RW 
sd dsk0g-01 vol-dsk0g-01 dsk0g-AdvFS 0 1450796 0 dsk0g ENA 
pl vol-dsk0g-02 vol-dsk0g ENABLED ACTIVE 1450796 CONCAT - RW 
sd dsk3g-01 vol-dsk0g-02 dsk3g-AdvFS 0 1450796 0 dsk3g ENA 


The previous example shows that there are three volumes: 

* rootvol 

* swapvol 

¢ vol-dskOg (which contains the /usr and /var partitions) 


Each volume has two plexes (listed in the rows labeled p1), indicating that 
the plexes were successfully mirrored on a disk called dsk3. 


The subdisks labeled root01-O01p and root02-02p are phantom subdisks. 
Each is 16 sectors long, and they provide write-protection for block 0, which 
prevents accidental destruction of the boot block and disk label. 


3.4.3.5 Displaying AdvFS File Domain Information 


If the root file system is AdvFS, the encapsulation process automatically 
changes the file domain information to reflect volume names instead of 
disk partitions. 
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To display the changed names: 
1. Change tothe fdmns directory: 


# cd /etc/fdmns 
2. Display attributes of all AdvFS file domains: 
# showfdmn * 


Information similar to the following is displayed that shows the volume 
name for each AdvFS file domain: 


Id Date Created LogPgs Version Domain Name 
381dc24d.000f2b60 Mon Nov 1 11:39:41 1999 512 4 yroot_domain 
Vol 512-Blks Free % Used Cmode Rblks Whbhlks Vol Name 
1L 262144 80016 69% on 32768 32768 /dev/vol/rootdg/rootvol 
Id Date Created LogPgs Version Domain Name 
381dc266.0009fe30 Mon Nov 1 11:40:06 1999 512 4 usr_domain 
Vol 512-Blks Free % Used Cmode Rblks Whbhlks Vol Name 
1L 1450784 851008 41% on 32768 32768 /dev/vol/rootdg/vol-dsk0g 


3.4.3.6 Displaying UFS File System Information 


If the root file system is UFS, the encapsulation process automatically 
changes the mount information to reflect volume names instead of disk 
partitions. 


To display the volume names for the root file system, enter: 
# mount 
Information similar to the following is displayed. File systems of the 


form /dev/vol/disk_group/volume indicate that the file system is 
encapsulated into LSM volumes. 
/dev/vol/rootdg/rootvol on / type ufs (rw) 


/dev/vol/rootdg/vol-dsk2g on /usr type ufs (rw) 
/proc on /proc type procfs (rw) 


3.4.3.7 Displaying Swap Volume Information 
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To display the volume information for the swap space, enter: 
# Swapon -s 


Information similar to the following is displayed: 


Swap partition /dev/vol/rootdg/swapvol (default swap) : 


Allocated space: 20864 pages (163MB) 
In-use space: 234 pages ( 1%) 
Free space: 20630 pages ( 98%) 


Total swap allocation: 
Allocated space: 20864 pages (163.00MB) 
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Reserved space: 7211 pages ( 34%) 
In-use space: 234 pages ( 1%) 
Available space: 13653 pages ( 65%) 


3.4.3.8 Unencapsulating the Boot Disk 


You can unencapsulate the boot disk to convert LSM volumes on the boot 
disk back to partitions. This process involves rebooting the system. 


The unencapsulation process changes the following files: 


e Ifthe root filesystem is UFS, the /etc/fstab file is changed to use disk 
partitions instead of LSM volumes. 


¢ Ifthe root file system is AdvFS, the /etc/fdmns/* directory is updated 
to change domain directories that have disk partitions associated with 
the boot disk. 


« The /etc/sysconfigtab file is changed to update the swapdevice 
entry to not use LSM volumes and to set the lsm_rootdev_is_ volume 
entry to 0. 


Before You Begin 


If your boot disk is mirrored, you must know which mirror you 
boot from. Before unencapsulating, you must reboot using this 
disk. 


To unencapsulate the boot disk: 
1. Iftheboot disk is mirrored, do the following. If not, continue with step 2. 


a. Enter the following command to display volume information: 
# volprint -ht 


In the output, note the names of the secondary plexes (usually 
those with the - 02 suffix). 


b. Remove the secondary plexes for volumes relating to the boot disk: 


# volplex -o rm dis volume-02 
For example, to remove the secondary plexes for the rootvol, 
swapvol and vol-dskOg volumes, enter: 


# volplex -o rm dis rootvol-02 
# volplex -o rm dis swapvol-02 
# volplex -o rm dis vol-dsk0g-02 


The disks that the secondary plexes used remain under LSM 
control, as members of the rootdg disk group. 
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2. Change the boot disk environment variable to point to the remaining 
boot disk: 


# consvar -s bootdef dev boot disk 


3. Convert the LSM boot disk volumes back to boot disk partitions. This 
command reboots the system: 


# volunroot -a 


3.4.4 Configuring the Automatic Data Relocation (Hot-Sparing) 
Feature 


You can enable the LSM hot-sparing feature to configure LSM to 
automatically relocate data from a failed disk in a volume that uses either a 
RAID 5 plex or mirrored plexes. LSM relocates the data to either a reserved 
disk that you configured as a spare disk or to free disk space in the disk 
group. LSM does not use a spare disk for normal data storage unless you 
specify otherwise. 


During the hot-sparing procedure, LSM: 


e Sends mail tothe root account (and other specified accounts) with 
notification about the failure and identifies the affected LSM objects. 


« Determines which LSM objects to relocate. 


e Relocates the LSM objects from the failed disk to a spare disk or to free 
disk space in the disk group. However, LSM will not relocate data if 
redundancy cannot be preserved. For example, LSM will not relocate 
data to a disk that contains a mirror of the data. 


When a partial disk failure occurs (that is, a failure affecting only some 
subdisks on a disk), data on the failed portion of the disk is relocated and 
data in the unaffected portions of the disk remain accessible. 


¢ Updates the configuration database with the relocation information. 
e Ensures that the failed disk space is not recycled as free disk space. 


¢ Sends mail to the root account (and other specified accounts) about 
the action taken. 


If you choose not to use the hot-spare feature, you must investigate and 
resolve disk failures manually. See Section 6.5 for more information. 


3.4.4.1. Enabling the Hot-Sparing Feature 


The hot-sparing feature is part of the volwatch daemon. The volwatch 
daemon has two modes: 


e Mail-only, which is the default. You can reset the daemon to this mode 
with the -m option. 
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¢« Mail-and-spare, which you set with the -s option. 
You can specify mail addresses with either option. 


To enable the hot-sparing feature, enter: 


# volwatch -s [mail-address...] 


Note 


Only one volwatch daemon can run on a system or cluster node 
at any time. The daemon’s setting applies to the entire system 
or node; you cannot specify some disk groups to use hot-sparing 
but not others. 


To return the volwatch daemon to mail-only mode, enter: 


# volwatch -m [mail-address...] 


3.4.4.2 Configuring and Deconfiguring a Spare Disk 


You should configure at least one spare disk in each disk group that contains 
volumes with mirror plexes or a RAID 5 plex. 


To configure a disk as a spare, enter: 
# voledit [-g disk group] set spare=on disk 


For example, to configure a spare disk called dsk5 in the rootdg disk group, 
enter: 


# voledit set spare=on dsk5 
To deconfigure a spare disk, enter: 
# voledit [-g disk group] set spare=off disk 


For example, to deconfigure a spare disk called dsk5 in the rootdg disk 
group, enter: 


# voledit set spare=off dsk5 


3.4.4.3 Setting Up Mail Notification for Exception Events 


The volwatch daemon monitors LSM for exception events. If an exception 
event occurs, mail is sent to the root account and to other accounts that 
you specify: 


e« When you use the rcmgr command to set the VOLWATCH_ USERS variable 
in the /etc/rce.config.common file. See the rcmgr(8) reference page 
for more information on the remgr command. 


¢ On the command line with the volwatch command. 
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There is a 15-second delay before the event is analyzed and the message is 
sent. This delay allows a group of related events to be collected and reported 
in a single mail message. 


Example 3-1 shows a sample mail notification sent when LSM detects an 
exception event. 


Example 3—1: Sample Mail Notification 


Failures have been detected by the Logical Storage Manager: 


failed disks: 
disk 


failed plexes: 
plex 


failed log plexes: 
plex 


failing disks: 
disk 


failed subdisks: 
subdisk 


The Logical Storage Manager will attempt to find spare disks, 
relocate failed subdisks and then recover the data 
in the failed plexes. 


The following describes the sections of the mail notification: 


¢ The disk under failed disks specifies disks that appear to have 
failed completely. 


« Theplex under failed plexes shows plexes that are detached due 
tol/O failures experienced while attempting to do I/O to subdisks they 
contain. 


« Theplex under failed log plexes indicates RAID 5 or dirty region 
log (DRL) plexes that have experienced failures. 
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¢ Thedisk under failing disks indicates a partial disk failure or a disk 
that is in the process of failing. When a disk has failed completely, the 
same disk appears under both failed disks and failing disks. 


¢ The subdisk under failed subdisks indicates a subdisk ina RAID 5 
volume that is detached due to 1/O errors. 


Example 3-2 shows the mail message sent if a disk completely fails. 


Example 3-2: Complete Disk Failure Mail Notification 


To: root 
Subject: Logical Storage Manager failures on servername.com 


Failures have been detected by the Logical Storage Manager 


failed disks: 
disk02 


failed plexes: 
home - 02 
src-02 
mkting-01 


failing disks: 
disk02 


This message shows that a disk called disk0O2 was failing, then detached by 
a failure and that plexes called home-02, src-02 and mkting-01 were also 
detached (probably due to the disk failure). 


Example 3-3 shows the mail message sent if a disk partially fails. 


Example 3-3: Partial Disk Failure Mail Notification 


To: root 
Subject: Logical Storage Manager failures on servername.com 


Failures have been detected by the Logical Storage Manager: 


failed disks: 
disk02 


failed plexes: 
home-02 
srco-02 
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Example 3-4 shows the mail message sent if data relocation is successful 
and data recovery is in progress. 


Example 3—4: Successful Data Relocation Mail Notification 


Volume volume Subdisk subdisk relocated to new_subdisk, 
but not yet recovered. 


If the data recovery is successful, the following message is sent: 
Recovery complete for volume volume in disk group disk_group. 
If the data recovery is unsuccessful, the following message is sent: 
Failure recovering volume in disk group disk_group. 


Example 3-5 shows the mail message sent if relocation cannot occur because 
there is no spare or free disk space. 


Example 3-5: No Spare or Free Disk Space Mail Notification 


Relocation was not successful for subdisks on disk disk 
in volume volume in disk group disk_group. 
No replacement was made and the disk is still unusable. 


The following volumes have storage on disk: 


volumename 


These volumes are still usable, but the redundancy of those 
volumes is reduced. Any RAID5 volumes with storage on the 
failed disk may become unusable in the face of further failures. 


Example 3-6 shows the mail message that is sent if data relocation fails. 


Example 3-6: Data Relocation Failure Mail Notification 


Relocation was not successful for subdisks on disk disk in 
volume volume in disk group disk group. 
No replacement was made and the disk is still unusable. 


error message 


In this output, error message iS a message indicating why the data 
relocation failed. 
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Example 3-7 shows the mail message sent if volumes not using RAID 5 
plexes are made unusable due to disk failure. 


Example 3—7: Unusable Volume Mail Notification 


The following volumes: 


volumename 


have data on disk but have no other usable mirrors 
on other disks. These volumes are now unusable and the data on them is 
unavailable. These volumes must have their data restored. 


Example 3-8 shows the mail message sent if volumes using RAID 5 plexes 
are made unusable due to disk failure. 


Example 3-8: Unusable RAID 5 Volume Mail Notification 


The following RAIDS volumes: 


volumename 


have storage on disk and have experienced 

other failures. These RAID5 volumes are now unusable 

and data on them is unavailable. These RAID5 volumes must 
have their data restored. 


3.4.4.4 Moving Relocated LSM Objects 


When the hot-sparing procedure occurs, the new locations of LSM objects 
might not provide the same performance or data |ayout that existed before 
the hot-sparing procedure occurred. After a hot-spare procedure, you might 
want to move the relocated LSM objects to improve performance, to keep the 
spare disk space free for future hot-sparing needs, or to restore the LSM 
configuration to its previous state. 


Note 


This procedure assumes you have identified and initialized a 
new disk to replace the hot-spare disk. See Section 6.5.5 for 
information on replacing a failed disk. See Section 4.1.2 for more 
information on adding disks for LSM use. 
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To move a subdisk that was relocated as the result of a hot-sparing procedure: 


1. Notethe characteristics of the LSM objects before they were relocated. 


This information is available from the mail notification sent to root. 
For example, look for a mail notification similar to the following: 


To: root 
Subject: Logical Storage Manager failures on host teal 


Attempting to relocate subdisk disk02-03 from plex home-02. 
Dev_offset 0 length 1164 dm_name disk02 da_name dsk2. 
The available plex home-01 will be used to recover the data. 


2. Note the new location for the relocated LSM object. 


This information is available from the mail notification sent to root. 
For example, look for a mail notification similar to the following: 


To: root 
Subject: Attempting LSM relocation on host teal 


Volume home Subdisk disk02-03 relocated to disk05-01, 
but not yet recovered. 


3. Movethe relocated data to the desired location: 


# volevac [-g disk group] hot_spare disk new disk 


4. MovetheLSM volume off the hot-spare disk onto the new disk. In this 
command, you must use the ! prefix toindicate the source disk: 


# volassist [-g disk group] move volume !hot spare new disk 
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Creating LSM Disk Groups and Volumes 


An LSM volume is an object that represents a hierarchy of LSM objects that 
allocates space to, and stores data for, a file system or application. You create 
an LSM volume differently depending on whether the volume is for a new 
file system or application or an existing file system or application. 


This chapter describes how to: 

¢ Create a disk group and check a diSk group for space (Section 4.1) 

¢ Create an LSM volume for new data (Section 4.2) 

¢« Configure UFS or AdvFS filesystems to use an LSM volume (Section 4.3) 
¢ Create an LSM volume for existing data (Section 4.4) 


Use the information from the worksheets you filled out in Chapter 2 to 
create disk groups and LSM volumes. 


4.1 Creating Disk Groups 


You must create an LSM volumeina disk group. By default, LSM creates 
volumes in the rootdg disk group, which was created when you installed 
LSM. You can create all LSM volumes in the rootdg disk group or you can 
create other disk groups. The following sections describe how to: 


¢ Display disk group information 

¢ Create a disk group 

e Add disks toa disk group 

¢ Create a backup copy of the disk label information 


4.1.1 Displaying Disk Group Information 


To display information about the rootdg disk group and other disk groups, 
enter: 


# voldisk list 


Information similar to the following is displayed: 


DEVICE TYPE DISK GROUP STATUS 
dsko sliced - unknown 
dsk1 sliced - - unknown 
dsk2 sliced dsk2 rootdg online 
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dsk3 sliced 
dsk4 sliced 
dsk5 sliced 
dske sliced 
dsk7 sliced 
dsk8 sliced 
dsk9 sliced 
dsk10 sliced 
dsk11 sliced 
dsk12 sliced 
dsk13 sliced 
where: 

DEVICE 

TYPE 

DISK 

GROUP 

STATUS 


dsk3 rootdg online 
dsk4 rootdg online 
dsk5 rootdg online 
dsk6é dg1 online 


= unknown 


dsk8 dg1 online 


unknown 
unknown 
unknown 
unknown 
unknown 


Specifies the disk access name assigned by the 
operating system software. 


Specifies the LSM disk type: sliced, simple, or nopriv. 


Specifies the LSM disk media name. An LSM disk media 
name displays only if the disk is in a disk group. 


Specifies the disk group to which the device belongs. A 
group name displays only if a disk is in a disk group. 


Specifies the status of the LSM device. The status is one of 
the following: 


online—The device was initialized for LSM use and is 
in use. 


offline—The device was initialized for LSM use, but 
is not available. 


unknown—LSM detected the device, but it was not 
initialized for LSM use (has no disk media name and is 
not part of a disk group). 


error — The disk is detected but has experienced |/O 
errors. 


failed was — An LSM disk media name exists but the 
disk is not associated with a DEVICE. Displays the last 
device associated with this name. 


To display the total usable space in a disk group, enter: 


# volassist [-g disk group] maxsize 


The following command line displays the available space in a disk group 


called dgl1: 


# volassist -g dgl maxsize 


Information similar to the following is displayed: 


Maximum volume size: 


6139904 (2998Mb) 
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4.1.2 Creating a Disk Group or Adding Disks to a Disk Group 


The voldiskadd script is an interactive script that lets you: 
e Initialize disks or disk partitions for exclusive use by LSM 
¢ Create a disk group 

e Add disks toa diSk group 


Note 


By default, LSM initializes each disk with one copy of the 
configuration database. If a disk group will have fewer than 

four disks, you should initialize each disk to have two copies of 
the disk group’s configuration database to ensure that the disk 
group has multiple copies in case one or more disks fail. You must 
use the voldisksetup command to initialize disks with more 
than one copy of the configuration database; see Section 5.1.1 for 
more information. 


If you specify an uninitialized disk, LSM initializes the disk as an LSM 
sliced disk. If you specify a partition name, LSM initializes the partition as 
an LSM simple disk. You can specify several disks and disk partitions at 
once, separated by a space; for example: 


# voldiskadd dsk3 dsk4a dsk5 dsk6ég 


After you initialize a disk or disk partition, LSM writes a new disk label and 
the disk or disk partition becomes an LSM disk for exclusive use by LSM. 


The voldiskadd script prompts you for the following information: 
¢« A disk group name 


If you are creating a disk group, the disk group name must be unique 
and can contain up to 31 alphanumeric characters that cannot include 
spaces or the forward slash (/ ). 


e« A disk media name for each disk you configurein the disk group 


You can use the default disk media name or you can assign a disk media 
name of up to 31 alphanumeric characters that cannot include spaces 
or the forward slash (/ ). 


e« Whether the disk should be a spare disk for the disk group 


A spare disk is a disk initialized by LSM, but used only as a replacement 
disk if a disk that contains a mirror or RAID 5 plex fails. See Section 3.4.4 
for more information about how LSM uses spare disks. For the best 
protection, configure at least one spare disk in each disk group that 
contains mirror or RAID 5 plexes. 
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The following example uses a disk called dsk9 to create a disk group called 
dg1: 


# voldiskadd dsk9 


Information similar to the following is displayed: 

Add or initialize disks 

Menu: VolumeManager/Disk/AddDisks 
Here is the disk selected. 
dsk9 

Continue operation? [y,n,q,?] (default: y) 
You can choose to add this disk to an existing disk group, a 
new disk group, or leave the disk available for use by future 
add or replacement operations. To create a new disk group, 
select a disk group name that does not yet exist. To leave 
the disk available for future use, specify a disk group name 
of "none". 

Which disk group [<group>,none,list,g,?] (default: rootdg) dgl 
There is no active disk group named dgl. 

Create a new group named dgl? [y,n,q,?] (default: y) 
The default disk name that will be assigned is: 
dg101 

Use this default disk name for the disk? [y,n,q,?] (default: y) 

Add disk as a spare disk for dgl? [y,n,q,?] (default: n) 
A new disk group will be created named dgl and the selected disks 
will be added to the disk group with default disk names. 
dsk9 

Continue with operation? [y,n,q,?] (default: y) 
The following disk device has a valid disk label, but does 
not appear to have been initialized for the Logical Storage 
Manager. If there is data on the disk that should NOT be 
destroyed you should encapsulate the existing disk partitions 
as volumes instead of adding the disk as a new disk. 
dsk9 

Initialize this device? [y,n,q,?] (default: y) 


Initializing device dsk9. 


Creating a new disk group named dgl containing the disk 
device dsk9 with the name dgl101. 


Goodbye. 
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4.1.3 Creating a Backup Copy of the Disk Label Information 


It is highly recommended that you create a backup copy of the updated disk 
label information for each LSM disk. 


Having this information will simplify the process of replacing a failed disk, 
by allowing you to copy the failed disk’s attributes to a new disk. Oncea disk 
fails, you cannot read its disk label, and you cannot copy that information to 
a new disk. 


To create a file that contains a backup copy of the disk label information, 
enter: 


# disklabel dskn > file 


See the disklabel(8) reference page for more information on the 
disklabel command. 


4.2 Creating an LSM Volume for New Data 


To create an LSM volume for a new file system or application, use the 
volassist command. Thevolassist command finds the necessary space 
within the disk group and creates all the objects for the volume. You must 
specify a volume name and length (size) on the command line. 


You can specify values for other LSM volume attributes on the command line 
or in a text file that you create. If you do not specify a value for an attribute, 
LSM uses a default value. 


To display the default values for volume attributes, enter: 
# volassist help showattrs 


Information similar to the following is displayed: 


#Attributes: 
layout=nomirror,nostripe, span,nocontig, raid5log,noregionlog, diskalign,nostorage 
mirrors=2 columns=0 nlogs=1 regionlogs=1 raid5logs=1 
min_columns=2 max_columns=8 
regionloglen=0 raid5loglen=0 logtype=region 
stripe stripeunitsize=64 raid5 stripeunitsize=16 
usetype=fsgen diskgroup= comment="" fstype= 
user=0 group=0 mode=0600 
probe_granularity=2048 
alloc= 
wantalloc= 
mirror= 


Some volume attributes have several options to define them. Some 
options define an attribute globally, while others define an attribute for 
a specific plex type. For example, you can specify the size of a stripe 
data unit using the stripeunit option for both striped or RAID 5 
plexes, the stripe _stripeunitsize option for striped plexes, or the 
raidS stripeunitsize option for RAID 5 plexes. 
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See the volassist(8) reference page for a complete list of attributes. 
Table 4-1 describes some of the common attributes for which you can specify 
a value. 


Table 4-1: Common LSM Volume Attributes 


Attribute Description Attribute Options 

Plex type layout={concate- 
nated|striped|raid5} 

Usage type -U {f£sgen|raid5|gen} 

Whether or not to create mirrors, mirror= {number | yes|no} 


and if so how many 


Whether or not to use a Dirty Region logtype={drl|none} 
Log (DRL) plex for mirrored plexes 


Size of the stripe width for a striped stripeunit=data_unit_size 
or RAID 5 plex 


Number of columns for a striped nstripe=number_of_columns 
or RAID 5 plex 


Creating a text file that specifies many of these attributes is useful if 

you create many LSM volumes that use the same nondefault values for 
attributes. Any attribute that you can specify on the command line can 
be specified on a separate linein the text file. By default, LSM looks for 
the /etc/default/volassist file when you create an LSM volume. If 
you created an /etc/default/volassist file, LSM creates each volume 
using the attributes that you specify on the command line and in the 
/etc/default/volassist file. 


Example 4-1 shows a text file called /etc/default/volassist that 
creates an LSM volume using a four-column striped plex with two mirrors, a 
stripe width of 32 KB, and no log. 


Example 4—1: LSM Volume Attribute Defaults File 


LSM Vn.n 
volassist defaults file. Use '#’ for comments 


number of stripes 
nstripe=4 


layout 
ayout=striped 


mirroring 
nmirror=2 


logging 
ogtype=none 


stripe size 
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Example 4—1: LSM Volume Attribute Defaults File (cont.) 


stripeunit=32k 


For example, to create an LSM volume using the attributes in the 
/etc/default/volassist file, enter: 


# volassist make volume length 


To specify a file other than the /etc/default/volassist file, you must 
use the volassist command with the -d option followed by the name of the 
file. If you use the -d option, LSM creates the volume using the attributes 
that you specify on the command line and in the named file. 


For example, to create an LSM volume using the attributes in a file other 
than the /etc/default/volassist file, enter: 


# volassist make volume length -d filename 
The following lists the order in which LSM assigns values to attributes: 
Values on the command line 


Values in a file that you specify by using the volassist -d option 
Values in the /etc/default/volassist file 


BON 


Default values 


4.2.1 Creating an LSM Volume Using a Concatenated Plex 


Creating an LSM volume that uses a concatenated plex can be a three-step 
process. Step 1 is required, and the others are required only if you want to 
mirror the plex. To increase performance for mirror plexes, you can specify 
the disks for the data plexes and the DRL plex to ensure that LSM creates 
these plexes on different disks, preferably on different buses. 


To create an LSM volume that uses a concatenated plex: 


1. Create a volume with a single plex, optionally specifying disks: 
# volassist [-g disk group] make volume length [disks] 


The following example creates a 3 GB volume called vol2 that uses disks 
dsk2, dsk3, and dsk4 in a disk group called dg1: 


# volassist [-g dg1] make vol2 3g dsk2 dsk3 dsk4 


The volume is created and started. If you want to mirror the plex, 
continue with step 2. 
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2. Addamirror plex tothe volume, specifying disks not used in the first 
data plex and preferably on different buses: 


# volassist [-g disk group] mirror volume init=active \ 
layout=nolog disks 

The init=active option prevents LSM from synchronizing the plexes. 
Because the volume is new and contains no data yet, LSM does not 
need to synchronize the plexes. 


The following example creates a mirror plex for the same volume, using 
disks dsk5, dsk6, and dsk7: 


# volassist -g dgl mirror vol2 init=active \ 
layout=nolog dsk5 dsk6é dsk7 


Note 


Because two mirrors are used in the volume, 6 GB of free 
space is needed. Each mirror uses 3 GB of disk space. 


3. AddaDRL plex tothe volume, specifying a disk that is not used by one 
of the data plexes: 


# volassist addlog volume disk 

The following example adds a DRL plex to vol2 on a disk called dsk10: 
# volassist addlog vol2 dsk10 

The volume is ready for use. 


4.2.2 Creating an LSM Volume Using a Striped Plex 


Creating an LSM volume that uses a striped plex can bea three-step process. 
Step 1 is required, and the others are required only if you want to mirror the 
plex. To increase performance for mirror plexes, you can specify the disks for 
the data plexes and the DRL plex to ensure that LSM creates these plexes 
on different disks, preferably on different buses. 


Note 


In general, you should not use LSM to stripe data if you alsousea 
hardware controller to stripe data. |n some specific cases such a 
configuration can improve performance but only if: 


¢ Most of the volume!/O requests are large (= 1 MB). 


¢ TheLSM volume is striped over multiple RAID sets on 
different controllers. 


« TheLsSM stripe size is a multiple of the full hardware RAID 
stripe size. 
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The number of LSM columns in each plex in the volume should 
be equal to the number of hardware RAID controllers. See your 
hardware RAID documentation for information about how to 
choose the best number of columns for the hardware RAID set. 


By default, the volassist command creates columns for a striped plex on 
disks in alphanumeric order, regardless of their order on the command line. 


To improve performance, you might want to create columns using disks on 
different buses. See Section 4.2.3 for more information about specifying the 
disk order for columns in a striped plex. 


To create an LSM volume that uses striped plexes: 


1. 


Create a volume with a single plex, optionally specifying disks, 
preferably on different buses: 


# volassist [-g disk group] make volume length \ 


layout=stripe [nstripe=number of columns] \ 
[stripeunit=data unit size] [disks] 


The following example creates a 4 GB volume called vol_stripe that 
uses disks dsk2, dsk3 and dsk4 to create a three-column striped plex 
in a disk group called dgl1: 


# volassist -g dgl make vol stripe 4g \ 
layout=stripe nstripe=3 dsk2 dsk3 dsk4 


The volume is created and started. If you want to mirror the plex, 
continue with step 2. 


Add a mirror plex to the volume, specifying disks on a different bus: 


# volassist [-g disk group] mirror volume \ 
init=active layout=nolog disks 


The init=active option prevents LSM from synchronizing the plexes. 
Because the volume is new and contains no data yet, LSM does not 
need to synchronize the plexes. 


The following example creates a mirror plex for the volume vol_ stripe, 
using disks dsk5, dsk6, and dsk7: 


# volassist -g dgl mirror vol stripe \ 
init=active layout=nolog dsk5 dsk6é dsk7 


Note 


Because two mirrors are used in the volume, 8 GB of free 
space is needed. Each mirror uses 4 GB of disk space. 
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3. AddaDRL plex tothe volume, specifying a disk that is not used by one 
of the data plexes: 


# volassist addlog volume disk 


The following example adds a DRL plex to vol_stripe on a disk called 
dsk10: 


# volassist addlog vol_ stripe dsk10 
The volume is ready for use. 


4.2.3 Creating an LSM Volume Using a Striped Plex (on Different 
Buses) 


By default, LSM creates columns for a striped plex on the first available 
disks it finds in the disk group. This might result in a volume with columns 
that use disks on the same bus. 


You can improve performance by creating a striped plex with columns that 
use disks on different buses. To do so, you must create the subdisks for 
each column. 


Each subdisk you create should be the same size, on a different disk ona 
different bus, and a multiple of the data unit size, so there is no wasted 
Space on the subdisk. For example, with a data unit size of 64 KB for a 
striped plex, each subdisk should be a multiple of 64. In the examples that 
follow, the subdisk size is 16 MB. 


Creating an LSM volume that uses a striped plex on different buses can bea 
six-step process. Steps 3 and 5 are required only if you want to mirror the 
plex. To increase performance for mirror plexes, you can specify the disks for 
the data plexes and the DRL plex to ensure that LSM creates these plexes 
on different disks, preferably on different buses. 


To create an LSM volume that uses a striped plex on different buses: 


1. Create the subdisks on disks on different buses: 


# volmake [-g disk group] sd subdisk disk len=length 


The following example creates subdisks on disks dsk2, dsk3, dsk4, dsk5, 
dsk6, and dsk7. In this example, disks dsk2 and dsk3 are on bus 1, dsk4 
and dsk5 are on bus 2, and dsk6 and dsk7 are on bus 3: 


volmake sd dsk2-01 dsk2 len=16m 
volmake sd dsk3-01 dsk3 len=16m 
volmake sd dsk4-01 dsk4 len=16m 
volmake sd dsk5-01 dsk5 len=16m 
volmake sd dsk6-01 dské len=16m 


# 
# 
# 
# 
# 
# volmake sd dsk7-01 dsk7 len=16m 
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Create a striped plex, specifying the order of subdisks on which to 
create the columns: 


# volmake [-g disk group] plex plex layout=stripe \ 
stwidth=data unit size sd=subdisk,... 


The following example uses the subdisks created in step 1 and lists 
them in alternating bus order to create a six-column striped plex called 
plex_01. Subdisks dsk2-01 and dsk3-01 are on bus 1, subdisks dsk4-01 
and dsk5-01 are on bus 2, and subdisks dsk6-01 and dsk7-01 are 

on bus 3, so the command line lists the subdisks in a pattern that 
alternates the bus order: 


# volmake plex plex 01 layout=stripe stwidth=64 \ 
sd=dsk2-01,dsk4-01,dsk3-01,dsk6-01,dsk5-01,dsk7-01 


Optionally, create a mirror plex for the volume. If the volume will have 
only one data plex, go to step 4. 


a. Repeat step 1 to create subdisks on a different group of disks on 
different buses for the second data plex. 


The following example creates subdisks for the columns in the 
second data plex on disks dsk8, dsk9, dsk10, dsk11, dsk12, and 
dsk13. In this example, disks dsk8 and dsk9 are on bus 4, dsk10 
and dsk11 are on bus 5, and dsk12 and dsk13 are on bus 6: 


volmake sd dsk8-01 dsk8 len=16m 
volmake sd dsk9-01 dsk9 len=16m 
volmake sd dsk10-01 dsk10 len=16m 
volmake sd dsk11-01 dsk11 len=16m 
volmake sd dsk12-01 dsk12 len=16m 
volmake sd dsk13-01 dsk13 len=16m 


th th GE SE SE te 


b. Repeat step 2 to create the second data plex specifying the order of 
subdisks on which to create the columns. 


The following example uses the subdisks created in step 3a and 
lists them in alternating bus order to create a six-column striped 
plex called plex_02. Subdisks dsk8-01 and dsk9-01 are on bus 

4, subdisks dsk10-01 and dsk11-01 are on bus 5, and subdisks 
dsk12-01 and dsk13-01 are on bus 6, sothe command line lists the 
subdisks in a pattern that alternates the bus order: 


# volmake plex plex 02 layout=stripe stwidth=64 \ 
sd=dsk8-01,dsk10-01,dsk9-01,dsk12-01,dsk11-01,dsk13-01 


Create the LSM volume, specifying the name of the data plex you 
created in step 2, and the additional data plex (if any) you created in 
step 3: 


# volmake [-g disk group] -U usage type vol volume \ 
plex=plex ... 
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The following example creates an LSM volume called vol9 with a usage 
type of fsgen, using a plex called plex_stripe: 


# volmake -U fsgen vol vol9 plex=plex stripe 


The following example creates an LSM volume called vol_mirr with a 
usage type of fsgen, using data plexes called plex_01 and plex_02: 


# volmake -U fsgen vol vol mirr plex=plex 01,plex 02 


5. Ifthe volume has mirror plexes, add a DRL plex to the volume on a disk 
that is not used by one of the data plexes: 


# volassist addlog volume disk 
6. Start the LSM volume: 
# volume start volume 


The volume is ready for use. 


4.2.4 Creating an LSM Volume Using a RAID 5 Plex 


By default, the volassist command creates columns for a RAID 5 plex on 
disks in alphanumeric order, regardless of their order on the command line. 


To improve performance, you might want to create the columns on disks on 
different buses. See Section 4.2.5 for more information about specifying the 
disk order for columns in a RAID 5 plex. 


The volassist command automatically creates a RAID 5 log plex for the 
volume. 
To create an LSM volume that uses a RAID 5 plex, enter: 


# volassist [-g disk group] -U raid5 make volume \ 
length layout=raid5 [nstripe=number of columns] \ 
[stripeunit=data_ unit size] [disks] 


The following example creates a 6 GB, six-column volume called vol6ina 
disk group called dg1, using any available disks: 


# volassist -g dgl -U raid5 make vol6 6g layout=raid5 nstripe=6 


4.2.5 Creating an LSM Volume Using a RAID 5 Plex (on Different 
Buses) 


By default, LSM creates columns for a RAID 5 plex on the first available 
disks it finds in the disk group. This might result in a volume with columns 
that use disks on the same bus. 


You can improve performance by creating a RAID 5 plex with columns that 
use disks on different buses. To do so, you must create the subdisks for 
each column. 
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Each subdisk you create should be the same size, on a different disk ona 
different bus, and a multiple of the data unit size, so there is no wasted 
space on the subdisk. For example, with a stripe width of 16 KB for a RAID 
5 plex, each subdisk should be a multiple of 16. 


To create an LSM volume that uses a RAID 5 plex on different buses: 


1. Create the subdisks on disks on different buses: 


# volmake [-g disk group] sd subdisk disk,offset,length 


The following example creates 1 MB subdisks for the data plex on disks 
called dsk6, dsk7, dsk8, and dsk9. In this example, disks dsk6 and dsk7 
are on bus 1, and dsk8 and dsk9 are on bus 2: 


# volmake sd dsk6-01 dsk6 len=1m 
# volmake sd dsk7-01 dsk7 len=1m 
# volmake sd dsk8-01 dsk8 len=1m 
# volmake sd dsk9-01 dsk9 len=1m 


2. Createthe RAID 5 data plex, specifying the order of subdisks on which 
to create the columns: 


# volmake [-g disk group] plex plex layout=raid5 \ 
stwidth=data unit size sd=subdisk,... 


The following example uses the subdisks created in step 1 to create a 
four-column RAID 5 data plex called plex-01: 


# volmake plex plex-01 layout=raid5 stwidth=16 \ 
sd=dsk6-01,dsk8-01,dsk7-01,dsk9-01 


Note that in this plex, the stripe alternates between subdisks on buses 1 
and 2. 


3. Createthe LSM volume, specifying the data plex: 
# volmake [-g disk group] -U raid5 vol volume plex=plex 


The following example creates an LSM volume called vol5 using the 
plex called plex-01: 


# volmake -U raid5 vol vol5 plex=plex-01 


4. AddaRAID 5 log plex tothe volume, on a disk that is not used by the 
data plex: 


# volassist addlog volume disk 


5. Start the LSM volume: 


# volume start volume 


The volume is ready for use. 


Creating LSM Disk Groups and Volumes 4-13 


4.2.6 Creating an LSM Volume for Secondary Swap Space 


If disk errors occur in the swap space, a system crash is likely to occur. You 
can create an LSM volume using mirrored concatenated plexes to protect 
against disk |/O errors in the secondary swap space. Do not create a DRL 
plex for swap volumes, because mirror resynchronization is not necessary, 
and a DRL plex on swap volumes will interfere with crash dumps. 


To create an LSM volume for the secondary swap space: 


1. Create an LSM volume without a log: 


# volassist [-g disk group] -U gen make volume length \ 
nmirror=n layout=nolog 


The following example creates an LSM volume called vol_swap2 that 
uses two mirrors with no log: 
# volassist -U gen make vol swap2 nmirror=2 layout=nolog 

2. Set the LSM volume with the start _ops=norecov option soLSM 
does not resynchronize the mirrors: 
# volume set start _opts=norecov volume 

3. Add theLSM volume as secondary swap space using the swapon 
command: 
# swapon /dev/vol/volume 


4. AddtheLSM device special file to the swapdevice kernel attribute 
value within the vm: section of the /etc/configtab file. The following 
example shows the entry to change: 


vm: 
swapdevice=/dev/disk/dsk1lb, /dev/vol/volume 


See the Systen Administration guide and the swapon(8) and sysconfig(8) 
reference pages for more information on adding additional swap space. 


4.3 Configuring File Systems to Use LSM Volumes 


After you create an LSM volume, you use it the same way you would use a 
disk partition. Because LSM uses the same interfaces as disk device drivers, 
you can specify an LSM volume in any operation where you can specify a 
disk or disk partition. 


The following sections describe how to configure UFS and AdvFS to use 
an LSM volume. 
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4.3.1 Creating a UFS File System on an LSM Volume 


To create a UFS on an LSM volume: 


1. 


Create a UFS usingtheLSM disk group and volume name: 

# newfs [options] /dev/rvol/disk group/volume 

The following example creates a UFS on an LSM volume called vol_ufs 
in the dg1 disk group: 

# newfs /dev/rvol/dgl1/vol_ufs 


It is not necessary to specify the name of the disk group for LSM 
volumes in the rootdg disk group. 


See the newfs(8) reference page for information on newfs options. 
UsetheLSM block special device name to mount the file system: 

# mount /dev/vol/disk_group/volume /mount_point 

The following example mounts the LSM volume called vol_ufs as mnt2: 


# mount /dev/vol/dg1/vol_ufs /mnt2 


4.3.2 Creating an AdvFS File Domain on an LSM Volume 


To create an AdvFS file domain on an LSM volume: 


1. 


Create the AdvF S file domain using the LSM disk group and volume 
name: 


# mkfdmn [options] /dev/vol/disk group/volume domain 


The following example creates an AdvFS file domain called dom1 on an 
LSM volume called vol_advfs in the dg1 disk group: 


# mkfdmn /dev/vol/dgl/vol_advfs doml 


It is not necessary to specify the name of the disk group for LSM 
volumes in the rootdg disk group. 


See the mk £dmn(8) reference page for information on mkf£dmn options. 
Create the AdvFS file set in the AdvFS domain: 
# mkfset domain file set 


The following example creates an AdvFS file set called fs1 in an AdvFS 
domain called dom1: 


# mkfset doml fsl 
Mount the file system: 


# mount domain#file set /mount_point 
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The following example mounts the AdvFS file set called fs1 in the 
AdvFS domain called dom1 as mnt2: 


# mount doml#fs1l /mnt2 


Note 


You can add more LSM volumes to an existing AdvFS domain if 
the domain needs more storage by creating a new LSM volume 
and using the AdvFS addvol command to add the volume to the 
domain. See AdvFS Administration for more information. 


4.4 Creating an LSM Volume for Existing Data 


When you create an LSM volume for existing data on a disk or partition, 
LSM: 


¢ Converts the disk or partition toan LSM nopriv disk 
e Encapsulates the data in the disk or partition 


¢ Configures the disk or partition into an LSM volume in the rootdg disk 
group 


You can encapsulate data in: 

¢ Disks and disk partitions (Section 4.4.1) 
e« AdvFS storage domains (Section 4.4.2) 

¢« The boot disk (Section 3.4.3) 


4.4.1 Encapsulating Disks and Disk Partitions 


The encapsulation procedure configures disks and disk partitions into LSM 
nopriv disks using information in the disk label and in the /etc/fstab 
file. After the encapsulation, entries in the /etc/fstab file or in the 
/etc/sysconfigtab file are changed to use the LSM volume name instead 
of the block device name of the disk or disk partition. 


If you encapsulate an entire disk (by not specifying a partition letter), such 
as dsk3, all of the in-use partitions are encapsulated as one LSM nopriv disk. 


To encapsulate a disk or disk partition: 


1. Back up the data on the disk or disk partition to be encapsulated. 


2. Unmount the disk or partition or take the data off line. If you cannot 
unmount the disk or partition or take the data off line, you must reboot 
the system to complete the encapsulation procedure. 


3. Create the LSM encapsulation script: 
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# volencap [-g disk group] {disk|partition} 


The following example creates an encapsulation script for a disk called 
dsk3: 


# volencap dsk3 


Note 


Although you can encapsulate several disks or disk partitions 
at the same time, it is recommended that you encapsulate 
each disk or disk partition separately. 


4. Complete the encapsulation process: 
# volreconfig 


If the encapsulated disk or disk partition is in use, the volreconfig 
command prompts you to reboot the system. 


4.4.2 Encapsulating AdvFS File Domains 


If an AdvFS file domain consists of one disk partition, you can encapsulate 
it for use with the LSM software using the procedure described in 

Section 4.4.1. If the AdvFS domain consists of multiple disk partitions, 

you can encapsulate the AdvF S file domain instead of the individual disk 
partitions. When you encapsulate an AdvF S file domain, LSM changes the 
links in the domain tree to point tothe LSM volumes. LSM creates a volume 
for each AdvFS partition in the domain. 


No mount point changes are necessary during encapsulation, because 

the mounted file sets are abstractions to the domain. The domain can be 
activated normally after the encapsulation process completes. Once the 
domain is activated, the file sets remain unchanged and the encapsulation is 
transparent to AdvFS domain users. 


To encapsulate an AdvF S file domain: 


1. Back up the data in the AdvFS file domain to be encapsulated. 


2. Makesurethat the AdvFS file domain is not in use and unmount all 
file sets. 


If you cannot unmount the file sets, you must reboot the system to 
complete the encapsulation procedure. 


3. Create the LSM encapsulation script: 


# volencap domain 


The following example creates an encapsulation script for an AdvFS 
file domain called dom1: 
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# volencap doml 
4. Complete the encapsulation procedure: 
# volreconfig 


If the AdvFS file domain is mounted, the volreconfig command 
prompts you to reboot the system. 


The /etc/fdmns directory is updated on successful creation of LSM 
volumes. 
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Managing LSM Objects 


This chapter describes how to manage LSM objects using LSM commands. 
You can also accomplish the tasks described in this chapter using: 


¢« The Storage Administrator (Appendix A) 

¢ Thevoldiskadm menu interface (Appendix C) 

¢ The Visual Administrator (Appendix D) 

For more information on an LSM command, see the reference page 


corresponding to its name. For example, for more information on the 
volassist command, enter: 


# man volassist 


5.1 Managing LSM Disks 


The following sections describe how to use LSM commands to manage LSM 
disks. 


5.1.1 Creating an LSM Disk 
You create an LSM disk when you initialize a disk or partition for LSM use. 
When you initialize a disk or partition for LSM use, LSM: 
¢ Destroys data on the disk 
¢« Formats the disk as an LSM disk 
e Assigns it a disk media name 
e Writes a new disk label 
You can configure an LSM disk in a disk group or as a spare disk. If you 
configure the LSM disk in a disk group, LSM uses it to store data. If you 


configure an LSM disk as a spare, LSM uses it as a replacement for a failed 
LSM disk that contains a mirror or RAID 5 plex. 


If the disk is new to the system, enter the voldct1 enable command after 
entering thehwmgr -scan scsi command tomakeLSM recognizethe disk. 


To initialize a disk or partition as an LSM disk, you can use: 
¢ Thevoldiskadd script as described in Section 4.1.2. 
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¢ Thevoldisksetup command. 


# voldisksetup -i {disk|partition} 


Speci 


Note 


By default, LSM initializes each disk with one copy of the 
configuration database. If a disk group will have fewer than 
four disks, you should initialize each disk to have two copies 
of the disk group’s configuration database to ensure that the 
disk group has multiple copies in case one or more disks fail. 
You must use the voldisksetup command to enable more 
than one copy of the configuration database. 


fying a disk access name initializes the entire disk as an LSM 


sliced disk. Specifying a partition name initializes the partition as an 


LSM 


simple disk. 


To initialize one or more disks, optionally setting the number of 
configuration copies to 2, enter: 


# voldisksetup -i disk ... [nconfig=2] 


After 


you initialize a disk or disk partition as an LSM disk, you can 


add it to a disk group. See Section 5.2.2 for information on creating a 
disk group or Section 5.2.3 for information on adding an LSM disk to an 


existi 


ng disk group. 


5.1.2 Displaying LSM Disk Information 


To display detailed information for an LSM disk, enter: 


# voldisk list disk 


The following example contains information for an LSM disk called dsk5: 


Device: 
devicetag: 
type: 
hostid: 
disk: 
group: 
flags: 
pubpaths: 
privpaths: 
version: 
iosize: 
public: 
private: 
update: 
headers: 
configs: 
logs: 


dsk5 

dsk5 

sliced 

servername 

name=dsk5 id=942260116.1188.servername 
name=dgl1 id=951155418.1233.servername 
online ready autoimport imported 
block=/dev/disk/dsk5g char=/dev/rdisk/dsk5g 
block=/dev/disk/dsk5h char=/dev/rdisk/dsk5h 
n.n 

min=512 (bytes) max=2048 (blocks) 

slice=6 offset=16 len=2046748 

slice=7 offset=0 len=4096 

time=952956192 seqno=0.11 

0 248 

count=1 len=2993 

count=1 len=453 


Defined regions: 


config 


priv 17- 247[ 231]: copy=01 offset=000000 enabled 
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config priv 249- 3010[ 2762]: copy=01 offset=000231 enabled 
log priv 3011- 3463[ 453]: copy=01 offset=000000 enabled 


5.1.3 Renaming an LSM Disk 


When you initialize an LSM disk, you can assign it a disk media name or 
use the default disk media name, which is the same as the disk access name 
assigned by the operating system software. 


Caution 


Each disk in a disk group must have a unique name. To avoid 
confusion, you might want to ensure that no two disk groups 
contain disks with the same name. For example, both the rootdg 
disk group and another disk group could contain disks with a disk 
media name of dsk3. Because most LSM commands operate on 
the rootdg disk group unless you specify otherwise, you might 
perform operations on the wrong disk if multiple disk groups 
contain identically named disks. 


Thevoldisk list command displays a list of all the LSM disks 
on the system, in all disk groups. 


To rename an LSM disk, enter: 
# voledit rename old dm name new dm name 
For example, to rename an LSM disk called disk03 to diskOl1, enter: 


# voledit rename disk03 disk01 


5.1.4 Placing an LSM Disk Off Line 


You can place an LSM disk off line to: 
e« Prevent LSM from accessing it 


¢« Enable you to move the disk to a different physical location and have 
the disk retain its LSM identity 


Placing a disk off line closes its device file. You cannot place an LSM disk 
off line if it is in use. 


To place an LSM disk off line: 

1. RemovetheLSM disk from its disk group: 
# voldg -g disk group rmdisk disk 

2. PlacetheLSM disk off line: 


# voldisk offline disk 
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5.1.5 Placing an LSM Disk On Line 


To restore access toan LSM disk that you placed off line, you must place it 
on line. The LSM disk is placed in the free disk pool and is accessible to 
LSM again. After placing an LSM disk on line, you must add it toa disk 
group before an LSM volume can use it. If the disk belonged toa disk group 
previously, you can add it to the same disk group. 


To place an LSM disk on line, enter: 
# voldisk online disk 


See Section 5.2.3 for information on adding an LSM disk toa disk group. 


5.1.6 Moving Data from an LSM Disk 


You can move (evacuate) LSM volume data to other LSM disks in the same 

disk group if there is sufficient free space. If you do not specify a target LSM 
disk, LSM uses any available LSM disk in the disk group that has sufficient 
free space. Moving data off an LSM disk is useful in the event of disk failure. 


If the LSM disk contains a mirror plex or RAID 5 columns, do not move 
the contents of the LSM disk to another LSM disk that contains data from 
the same volume. 


To move data off an LSM disk, enter: 
# volevac [-g disk group] source disk target disk 


For example, to move data off an LSM disk called dsk8 and onto an LSM 
disk called dsk9, enter: 


# volevac dsk8 dsk9 


5.1.7 Removing an LSM Disk from LSM Control 
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You can remove an LSM disk from LSM control if you removed the disk from 
its disk group or deported its disk group. 


See Section 5.2.7 for information on removing an LSM disk from a disk 
group. See Section 5.2.4 for information on deporting a disk group. 


To remove an LSM disk, enter: 
# voldisk rm disk 


For example, to remove an LSM disk called dsk8, enter: 
# voldisk rm dsk8 
If you want to use the disk after it is removed from LSM control, you must 


initialize it using the disklabel command. See the disklabel(8) reference 
page for more information on the disklabel command. 
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5.2 Managing Disk Groups 


The following sections describe how to use LSM commands to manage disk 


groups. 


5.2.1 Displaying Disk Group Information 


There are three common ways to display disk group information. You can 


display: 


A list of all disks on the system in all disk groups. See Section 5.2.1.1. 


The total free space on disks in all disk groups. See Section 5.2.1.2. 


The maximum size volume you can create in a disk group. See 


Section 5.2.1.3. 


5.2.1.1 Displaying All LSM Disks 


To display a list of all LSM disks and the disk group to which each belongs, 


enter: 


# voldisk [-g disk group] list 


Information similar to the following is displayed: 


DEVICE 


ds 
ds 
ds 
ds 
ds 
ds 
ds 
ds 
ds 
ds 
ds 
ds 
ds 
ds 


kO 
k1 
k2 


TYPE 


s 
s 
s 
s 
s 
s 
s 
s 
s 
s 
s 
s 
s 
s 


iced 
iced 
iced 
iced 
iced 
iced 
iced 
iced 
iced 
iced 
iced 
iced 
iced 
iced 


DISK GROUP STATUS 
= = unknown 
- = unknown 
dsk2 rootdg online 
dsk3 rootdg online 
dsk4 rootdg online 
dsk5 rootdg online 
dsk6é dg1 online 
= = unknown 
dsk8 dg1 online 
- = unknown 
= = unknown 
- 7 unknown 
- = unknown 
= eS unknown 


The following list describes the preceding information categories: 


DEVICE 


The disk access name assigned by the operat- 
ing system software. 


The LSM disk type: sliced, simple, or nopriv. 


The LSM disk media name. An LSM disk media name 
is displayed only if the disk is in a disk group. 
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GROUP The disk group to which the disk belongs. A disk group 
name is displayed only if the disk is in a disk group. 


STATUS The status of the LSM disk: 
* online — The disk is detected by LSM and running. 


* offline — The disk has not been detected or was put 
off line manually. 


* unknown — The disk was detected but is not initialized 
for use by LSM. 


* error — The disk is detected but has experienced I/O 
errors. 


* failed was — AnLSM disk media name exists but the 
disk is not associated with a DEVICE. Displays the last 
device associated with this name. 


5.2.1.2 Displaying Free Space in Disk Groups 


To display the free space in one or all disk groups, enter: 


# voldg [-g disk group] free 


Information similar to the following is displayed: 


GROUP DISK DEVICE TAG OFFSET LENGTH FLAGS 
rootdg dsk2 dsk2 dsk2 2097217 2009151 - 
rootdg dsk3 dsk3 dsk3 2097152 2009216 = 
rootdg dsk4 dsk4 dsk4 0 4106368 os 
rootdg dsk5 dsk5 dsk5 0 4106368 - 
dgi dské dskeé dské 0 2046748 7 
dgl dsk8 dsk8 dsk8 0) 2046748 - 


The value in the LENGTH column indicates the amount of free disk space in 
512-byte blocks. (2048 blocks equal 1 MB.) 


5.2.1.3 Displaying the Maximum Size for an LSM Volume in a Disk Group 


To display the maximum size for an LSM volume that you can create in 
a disk group, enter: 


# volassist [-g disk group] maxsize 


The following example displays the maximum size for an LSM volume that 
you can create in a disk group called dg1: 


# volassist -g dgl maxsize 
Maximum volume size: 6139904 (2998Mb) 


5.2.2 Creating a Disk Group 


The default rootdg disk group is created when you install LSM and always 
exists on a system running LSM. You can create additional disk groups to 
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organize your disks into logical sets. Each disk group that you create must 
have a unique name and contain at least one simple or sliced LSM disk. 
An LSM disk can belong to only one disk group. An LSM volume can use 
disks from only one disk group. 


If you want to initialize LSM disks and create a new disk group at the 
same time, you can use the voldiskadd script. (See Section 4.1.2 for more 
information.) 


Note 


By default, LSM initializes each disk with one copy of the 
configuration database. If a disk group will have fewer than four 
disks, you should initialize each disk to have two copies of the 
disk group’s configuration database to ensure that the disk group 
has multiple copies in case one or more disks fail. You must use 
the voldisksetup command to enable more than one copy of the 
configuration database (Section 5.1.1). 


To create a new disk group using LSM disks, enter: 


# voldg init new disk group disk ... 


For example, to create a disk group called newdg using LSM disks called 
dsk100, dsk101, and dsk102, enter: 


# voldg init newdg dsk100 dsk101 dsk102 


5.2.3. Adding a Disk to a Disk Group 


To add a disk to an existing disk group, enter: 
# voldg [-g disk group] adddisk disk 
For example, to add the disk called dsk10 toa disk group called dg1, enter: 


# voldg -g dgl adddisk dsk10 


5.2.4 Deporting a Disk Group 


You can deport a disk group to make its volumes inaccessible. This enables 
you to: 


« Movethe disk group to another system 
e« Reuse the disks for other purposes 


You cannot deport the rootdg disk group. 


Managing LSM Objects 5-7 


Caution 


Although LSM displays the disks in a deported disk group as 
available, removing or reusing the disks in a deported disk group 
results in data loss. 


You must import a deported disk group before it can be used. See 
Section 5.2.5 for more information on importing a disk group. 


To deport a disk group: 


1. 


If volumes in the disk group are in use, stop the volumes: 

# volume [-g disk group] stopall 

Deport the disk group: 

# voldg deport disk group 

If you no longer need the disk group, you can: 

e Add the disks to different disk groups. See Section 5.2.3. 

e Usethedisks to create new disk groups. See Section 5.2.2. 
« Remove the disks from LSM control. See Section 5.1.7. 


5.2.5 Importing a Disk Group 


You can import a disk group to make a deported (inaccessible) disk group 
and its volumes accessible again. You cannot import a disk group if you 
reused any of its associated disks while it was deported. 


To import a disk group: 


1. 


Specify the disk group to import: 
# voldg import disk group 
Start all volumes within the disk group: 


# volume [-g disk group] startall 


5.2.6 Moving a Disk Group to Another System 
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1. 


You might want to move a set of disks from one system to another and retain 
the LSM objects and data on those disks. You can move any disk group 
except the rootdg disk group. 


To move a disk group to another system: 


Stop all activity on the volumes in the disk group and unmount any 
file systems. 
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Deport the disk group from the originating system: 
# voldg deport disk_group 
Physically move the disks to the new host system. 


Enter the following command on the new host system to scan for the 
disks: 


# hwmgr -scan scsi 

Import the disk group: 

# voldg import disk_group 
Start the volumes: 


# volume -g disk group startall 


5.2.7 Removing an LSM Disk from a Disk Group 


You can removean LSM disk froma disk group; however, you cannot remove: 


The last disk in a disk group unless the disk group is deported. See 
Section 5.2.4 for information on deporting a disk group. 


Any disk that is in use (for example, disks that contain active LSM 
volume data). If you attempt to remove a disk that is in use, LSM 
displays an error message and does not remove the disk. 


See Section 5.1.6 for information on moving data from a disk. See 
Section 5.4.6 for information on removing LSM volumes. 


To remove an LSM disk from a disk group: 


1. 


Verify that the LSM disk is not in use by listing all subdisks: 
# volprint -st 
Information similar to the following is displayed: 


Disk group: rootdg 


SD NAME PLEX DISK DISKOFFS LENGTH [COL/]OFF DEVICE MODE 
sd dsk1-01 klavol-01 dsk1l 0 1408 0/0 dsk1l ENA 
sd dsk2-02 klavol-03 dsk2 0 65 LOG dsk2 ENA 
sd dsk2-01 klavol-01 dsk2 65 1408 1/0 dsk2 ENA 
sd dsk3-01 klavol-01 dsk3 0 1408 2/0 dsk3 ENA 
sd dsk4-01 klavol-02 dsk4 0 1408 0/0 dsk4 ENA 
sd dsk5-01 klavol-02 dsk5 0 1408 1/0 dsk5 ENA 
sd dsk6-01 klavol-02 dsk6 0 1408 2/0 dsk6 ENA 


The disks in the DISK column are currently in use by LSM volumes, and 
therefore you cannot remove those disks froma disk group. 


Remove the LSM disk from the disk group: 


# voldg [-g disk group] rmdisk disk 
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For example, to remove an LSM disk called dsk8 from the rootdg disk 
group, enter: 


# voldg rmdisk dsk8 


The disk remains under LSM control. You can: 

e Add the disk toa different disk group. See Section 5.2.3. 

e Usethedisk to create a new disk group. See Section 5.2.2. 
e Remove the disk from LSM control. See Section 5.1.7. 


5.3 Managing the LSM Configuration Database 


This section describes how to manage the LSM configuration database, 
including: 


¢ Backing up the configuration database 
¢ Restoring the configuration database from backup 
¢« Modifying the configuration database properties 


5.3.1 Backing Up the LSM Configuration Database 


One important responsibility in managing a system with LSM is to 
periodically make a backup copy of the LSM configuration database. This 
helps you: 


e Restore volumes from backup after a major system failure 


¢ Recreate LSM volumes after disk failures, if the failures resulted in the 
loss of all configuration database copies 


The saved configuration database (also called a description set) is a record of 
the objects in the LSM configuration (the LSM disks, subdisks, plexes and 
volumes) and which disk group each object belongs to. 


Whenever you make a change to the LSM configuration, the backup copy 
becomes obsolete. As with any backup, the content is useful only as long as 
it accurately represents the current information. Any time the number, 
nature, or name of LSM objects change, consider making a backup of 

the LSM configuration database. The following list describes some of the 
changes that will invalidate a configuration database backup: 


¢« Creating disk groups 
e Adding or removing disks from disk groups or from LSM control 
¢ Creating or removing volumes 
¢« Changing the properties of volumes, such as 
- Plex layout 
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- Adding or removing plexes or logs 


Note 


Backing up the configuration database does not save the data in 
the volumes and does not save the configuration data for any 
volumes associated with the boot disk, if you encapsulated the 
boot disk. 


Depending on the nature of a boot disk failure, you might need 
to restore the system partitions from backups or installation 
media to return toa state where the system partitions are not 
under LSM control. From there, you can redo the procedures to 
encapsulate the boot disk partitions into LSM volumes and add 
mirror plexes to those volumes. 


See Section 6.5.6 for more information about recovering from a 
boot disk failure under LSM control. 


See Section 5.4.2 for information on backing up volume data. 


By default, LSM saves the entire configuration database to a timestamped 
directory called /usr/var/1sm/db/LSM. date. hostname. You can specify 
a different location for the backup, but the directory must not exist. 


In the directory, the backup procedure creates: 


A file called header, which contains host |D and checksum information, 
and a list of the other files in this directory. 


A copy of the volboot file. 

A file called voldisk.1list, which contains a list of all LSM disks, their 
type (sliced, simple, nopriv), the size of their private and public regions, 
their disk group, and other information. 

A subdirectory called rootdg.d, which contains the allvol .DF file. 


Theallvol . DF file contains detailed descriptions of every LSM subdisk, 
plex, and volume, describing all their properties and attributes. 


To back up the LSM configuration database: 


1. 


Enter the following command, optionally specifying a directory location 
other than the default to store the LSM configuration database: 


# volsave [-d directory| 


Save the backup to tape or other removable media. 
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You can save multiple versions of the configuration database; each new 
backup is saved in the /usr/var/1sm/db directory with its own date and 
time stamp, as shown in the following example: 


dr-xr-x--- 3 root system 8192 May 5 09:36 LSM.20000505093612.hostname 
dr-xr-x--- 3 root system 8192 May 10 10:53 LSM.20000510105256. hostname 


5.3.2 Restoring the LSM Configuration Database from Backup 


You can restore the configuration database of a specific disk group or 
volume or the entire configuration (all disk groups and volumes except those 
associated with the boot disk). If you have saved multiple versions of the 
configuration, you can choose a specific one to restore. If you do not choose 
one, LSM restores the most recent version. 


Note 


Restoring the configuration database does not restore data in the 
LSM volumes. See Section 5.4.3 for information on restoring 
volume data. 


To restore a backed-up LSM configuration database: 


1. Optionally, display a list of all available database backups: 
# 1ls /usr/var/1lsm/db 


If you saved the configuration database to a different directory, specify 
that directory. 


2. Restorethe chosen configuration database: 
¢ Torestore the entire configuration database, enter: 
# volrestore [-d directory] 
¢« Torestore a specific disk group configuration database, enter: 
# volrestore [-d directory] -g disk group 
¢« Torestore a specific volume configuration database, enter: 
# volrestore [-d directory] -v volume 


¢ Torestore a configuration database interactively, enabling you to 
select or skip specific objects, enter: 


# volrestore [-d directory] -i 
3. Start the restored LSM volumes: 
# volume -g disk group startall 


If the volumes will not start, you might need to manually edit the plex 
state. See Section 6.4.3. 
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4. \f necessary, restore the volume contents (data) from backup. See 
Section 5.4.3 for more information. 


5.3.3 Changing the Size and Number of Configuration Database 
Copies 


LSM maintains copies of the configuration database on separate physical 
disks within each disk group. When the disk group runs out of space in the 
configuration database, LSM displays a message similar to the following: 


volmake: No more space in disk group configuration 


This might happen in an LSM configuration that you restored froma system 
running a version of the operating system prior to Version 5.0. Earlier 
versions of LSM have smaller configuration databases. 


If you run out of disk space, you can reduce the number of copies of the 
configuration database. However, make sure that there are sufficient copies 
of the configuration database available for redundancy. 


To reduce the number of configuration copies: 
1. Display information about the disk group’s configuration database: 


# voldg [-g disk group] list 


The following example displays the number, size, and disk location of 
the configuration database information in the rootdg disk group: 


Group: rootdg 

dgid: 783105689.1025.1sm 
import-id: 0.1 

flags: 


config: seqno=0.1112 permlen=173 free=166 templen=6 loglen=26 
config disk dsk13 copy len=173 state=clean online 

config disk dsk13 copy 2 len=173 state=clean online 

config disk dskl1g copy 1 len=347 state=clean online 

config disk dsk10g copy 1 len=347 state=clean online 

log disk dskllg copy 1 len=52 

log disk dsk13 copy 1 len=26 

log disk dsk13 copy 2 len=26 

log disk dsk10g copy 1 len=52 


In the previous example: 


« Thelen information is the size, in blocks, of the configuration 
database. 


e The free=166 information indicates that there is enough spacein 
the rootdg disk group to create 166 additional LSM configuration 
records. 


¢ Disk dsk13 has two copies of the configuration database. 


2. Reduce the number of configuration copies on a disk that has more 
than one: 
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# voldisk moddb disk nconfig=1 


For example, to reduce the number of configuration copies on dsk13 
from two to one, enter: 


# voldisk moddb dsk13 nconfig=1 


5.4 Managing Volumes 


The following sections describe how to use LSM commands to manage LSM 
volumes. See Chapter 4 for information on creating LSM volumes. 


5.4.1 Displaying LSM Volume Information 


The volprint command displays information about LSM objects that 
make up an LSM volume. The following table lists the abbreviations used 
in volprint output: 


Abbreviation Specifies 

dg Disk group name 
dm Disk media name 
pl Plex name 

sd Subdisk name 

v LSM volume name 


To display LSM object information for an LSM volume, enter: 
# volprint [-g disk group] -ht volume 


Information similar to the following is displayed: 


Disk group: rootdg |1 


V NAME USETYPE KSTATE STATE LENGTH READPOL PREFPLEX 

PL NAME VOLUME KSTATE STATE LENGTH LAYOUT NCOL/WID MODE 
SD NAME PLEX DISK DISKOFFS LENGTH [COL/] OFF DEVICE MODE 

v klavo fsgen ENABLED ACTIVE 4096 SELECT - 2 

pl klavol-01 klavo ENABLED ACTIVE 4224 STRIPE 3/128 RW [3] 
sd dsk1-01 klavol-01 dsk1 0) 408 0/0 dsk1 ENA 4] 
sd dsk2-01 klavol-01 dsk2 65 408 1/0 dsk2 ENA 

sd dsk3-01 klavol-01 dsk3 0 408 2/0 dsk3 ENA 

pl klavol-02 klavo ENABLED ACTIVE 4224 STRIPE 3/128 RW 

sd dsk4-01 klavol-02 dsk4 0 408 0/0 dsk4 ENA 

sd dsk5-01 klavol-02 dsk5 0 408 1/0 dsk5 ENA 

sd dsk6-01 klavol-02 dsk6 0 408 2/0 dsk6 ENA 

pl klavol-03 klavo ENABLED ACTIVE LOGONLY CONCAT - RW 

sd dsk2-02 klavol-03 dsk2 0 65 LOG dsk2 ENA 
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This example shows output for a volume that uses a three-column striped 
plex that has one mirror plex. 


1] Disk group name 


2} Volume name (klavol), usage type (fsgen), state (ENABLED ACTIVE), 
and size (4096) information. 


3] Plex information. This volume has two data plexes, klavol-O1 and 
klavol-02, anda DRL plex, klavol-03. 


4) Subdisk information for the plex klavol-01. 


5.4.2 Backing Up an LSM Volume 


One of the more common tasks of a system administrator is helping users 
recover lost or corrupted files. To perform that task effectively, you must 
set up procedures for backing up LSM volumes and the LSM configuration 
database at frequent and regular intervals. You will need the saved 
configuration database as well as the backed-up data, if you need to restore 
a volume after a major failure. (For example, multiple disks in the same 
volume failed, and those disks contained the active configuration records for 
the disk group.) 


See Section 5.3.1 for information on backing up the LSM configuration 
database. 


Note 


If the volume is part of an Advanced File System domain, use the 
AdvFS backup utilities instead of LSM to back up the volume. 
See your AdvFS documentation for more information on the 
backup utilities available. See Section 5.3.1 for more information 
on backing up the LSM configuration database. 


The way you back up an LSM volume depends on the number and type of 
plexes in the volume: 


e If the volume has only one concatenated or striped plex, see 
Section 5.4.2.1. 


e |f the volume has mirror plexes, see Section 5.4.2.2. 
¢ Ifthe volume has a RAID 5 plex, see Section 5.4.2.3. 
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5.4.2.1. Backing Up a Volume with a Single Concatenated or Striped Plex 


To back up an LSM volume that has a single plex: 


1. 


10. 


If necessary, select a convenient time and inform users to save files and 
refrain from using the volume (the application or file system that uses 
the volume) while you back it up. 


Determine the size of the LSM volume and which disks it uses: 
# volprint -v [-g disk group] volume 


Ensure there is enough free space in the disk group to create a 
temporary copy of the LSM volume. The free space must be on disks 
that are not used in the volume you want to back up: 


# voldg [-g disk group] free 
If the volume contains a UNIX File System, unmount it. 


Create a temporary mirror plex for the LSM volume, running this 
operation in the background: 


# volassist snapstart volume & 


Create a new volume from the temporary plex. (The snapshot keyword 
automatically uses the temporary plex to create the new volume.) 


# volassist snapshot volume temp volume 


The following example creates a temporary LSM volume called 
vol1_backup for an LSM volume called vol1: 


# volassist snapshot voll voll backup 

Remount and resume use of the original LSM volume. 

Start the temporary LSM volume: 

# volume start temp volume 

Back up the temporary LSM volumeto your default backup device: 
# dump 0 /dev/rvol/disk_group/temp_ volume 


The following example backs up an LSM volume called vol1_backup 
in the rootdg disk group: 


# dump 0 /dev/rvol/rootdg/voll backup 
Stop and remove the temporary LSM volume: 


# volume stop temp volume 
# voledit -r rm temp volume 


See the dump(8) reference page for more information about the dump 
command. 
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5.4.2.2 Backing Up a Volume with Mirror Plexes 


Volumes with mirror plexes can remain in use while you back up their data, 
but any writes to the volume during the backup might result in inconsistency 
between the volume’s data and the data that was backed up. 


Caution 


If the LSM volume has only two data plexes, redundancy is not 
available during the backup. 


To back up an LSM volume that has mirror plexes: 


1. 


Dissociate one of the volume’s plexes, which leaves the plex as an image 
of the LSM volume at the time of dissociation: 


# volplex dis plex 
The following example dissociates a plex called vol01-02: 
# volplex dis vol01-02 


Create a temporary LSM volume using the dissociated plex. Run the 
command in the background, as it might take a long time depending on 
the size of the plex: 


# volmake -U fsgen vol temp volume plex=plex & 


The following example creates an LSM volume called vol01-temp using 
a plex called vol01-02: 


# volmake -U fsgen vol vol01-temp plex=vol01-02 & 

Start the temporary volume: 

# volume start temp volume 

Back up the temporary LSM volume to your default backup device: 
# dump 0 /dev/rvol/disk_group/temp_ volume 


The following example backs up an LSM volume called vol1_backup 
in the rootdg disk group: 


# dump 0 /dev/rvol/rootdg/voll backup 
Stop and remove the temporary LSM volume: 


# volume stop temp volume 
# voledit -r rm temp volume 


Reattach the dissociated plex to the original volume. If the volume is 
very large, you can run this operation in the background: 


# volplex att volume plex & 
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LSM automatically resynchronizes the plexes when you reattach the 
dissociated plex. This operation might take a long time, depending 
on the size of the volume. Running this process in the background 
returns control of the system to you immediately instead of after the 
resynchronization is complete. 


See the dump(8) reference page for more information about the dump 
command. 


5.4.2.3. Backing Up a Volume with a RAID 5 Plex 


You can back up a volume that uses a RAID 5 plex, but you must either stop 
all applications from using the volume while the backup is in process or 
allow the backup to occur while the volume is in use. 


If the volume remains in use during the backup, the volume data might 
change before the backup completes, and therefore the backup data will not 
be an exact copy of the volume’s contents. 


To back up a volume with a RAID 5 plex, enter: 


# dump 0 /dev/rvol/disk_group/volume 


5.4.3 Restoring an LSM Volume from Backup 


The way you restore an LSM volume depends on what the volume is used for 
and if the volume is configured and active 


Note 


If the volume is part of an AdvFS domain, consult your AdvFS 
documentation for the best method of restoring backed-up data. 


If the volume is used for an application such as a database, see 
that application’s documentation for the recommended method 
for restoring backed-up data. 


To restore a backed-up volume: 


e If the volume contains a UNIX File System and the volume still exists 
(for example, you replaced a failed disk), enter the following command to 
restore the data from the backup media: 


# restore -Y£ backup_volume 


e If the volume does not exist: 


1. Recreate the volume: 


# volrestore [-g disk group] -v volume 
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2. Recreate the file system: 

# newfs [options] /dev/rvol/disk_group/volume 
3. Mount the file system: 

# mount /dev/vol/disk_ group/volume /mount_point 
4. Restore the volume data: 


# restore -Yrf backup volume 


5.4.4 Starting an LSM Volume 


LSM automatically starts volumes when the system boots. You can manually 
start an LSM volume if you: 


¢« Stop a volume 
e Import a disk group that contains volumes 
To start an LSM volume, enter: 


# volume start [-g disk group] volume 


To start all volumes in a disk group (for example, after importing the disk 
group), enter: 


# volume [-g disk group] startall 


5.4.5 Stopping an LSM Volume 


LSM automatically stops LSM volumes when the system shuts down. When 
you no longer need an LSM volume, you can stop it then remove it. You 
cannot stop an LSM volume if a file system is using it. 


To stop an LSM volume: 
1. If applicable, stop a file system from using the LSM volume. 
¢ For AdvFS, unmount the file system and remove the file domain: 
# umount /filesystem 


# rmfdmn domain 


See the AdvFS Administration guide for more information about 
removing volumes from a domain. 


e« For UFS, unmount the file system: 


# umount /dev/rvol/volume 
2. Stop the LSM volume: 


# volume [-g disk group] stop volume 
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For example, to stop an LSM volume called voll in the dg1 disk group, 
enter: 


# volume -g dgl stop voll 
To stop all volumes, enter: 


# volume stopall 


5.4.6 Removing an LSM Volume 
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Removing an LSM volume destroys the data in that volume. Remove an 
LSM volume only if you are sure that you do not need the data in the 
LSM volume or the data is backed up elsewhere. When an LSM volume is 
removed, the space it occupied is returned to the free space pool. 


The following procedure also unencapsulates UNIX File Systems or 
Advanced File Systems. 


To remove an LSM volume: 


1. If applicable, stop a file system from using the LSM volume. 
¢ For AdvFS, unmount the file system and remove the file domain: 


# umount /filesystem 
# rmfdmn domain 


See the AdvFS Administration guide for more information about 
removing volumes from a domain. 


e« For UFS, unmount the file system: 


# umount /dev/rvol/volume 


2. Ifthe volume was configured as secondary swap, remove references to 
the LSM volume from the vm: swapdevice entry in the sysconfigtab 
file. If the swap space was configured using the /etc/fstab file, update 
this file accordingly. These changes are effective on the next reboot. 


See the Systen Administration guide and the swapon(8) reference page 
for more information. 


3. Stop the LSM volume: 
# volume [-g disk group] stop volume 
4. Remove the LSM volume: 
# voledit -r rm volume 
This step removes the plexes and subdisks and the volume itself. 


5. If the volume contained an encapsulated file system, do one of the 
following: 
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¢ For an encapsulated UNIX File System, edit the /etc/fstab file 
to change the volume name tothe disk name. For example, change 
/dev/vol/rootdg/vol-dsk4g to /dev/dsk4g. 


e For an encapsulated AdvFS file domain, run the following script: 


# /etc/vol/reconfig.d/domain.d/domain.d/ \ 
recovery/disk.sh 


If the script is not available, do the following: 

a. Change directory to the domain directory: 
# ed /etc/fdmns/domain 

b. Remove the volume: 


# rm volume 


c. Removethe link tothe disk device file: 


# In -s /dev/disk 


5.4.7 Recovering an LSM Volume 


You might need to recover an LSM volume that has become disabled. Alert 
icons and the Alert Monitor window might provide information when an 
LSM volume recovery is needed. (See the Systen Administration guide for 
more information about the Alert Monitor.) Recovering an LSM volume 
starts the disabled volume and, if applicable, resynchronizes mirror plexes 
or RAID 5 parity. 


To recover an LSM volume, enter the following command, specifying either 
the volume or a disk, if the disk is used by several volumes: 


# volrecover [-g disk group] -sb volume|disk 


(The -s option starts all disabled volumes, and the -b option runs the 
command in the background.) 


For example, to recover an LSM volume called vol01, enter: 
# volrecover -sb vol01 


To recover all LSM objects (Subdisks, plexes, or volumes) that use a disk 
called dsk5, enter: 


# volrecover -sb dsk5 


If you do not specify a disk group, LSM volume name, or disk name, all 
volumes are recovered. If recovery of an LSM volume is not possible, restore 
the LSM volume from backup. 
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5.4.8 Renaming an LSM Volume 


You can rename an LSM volume. The new LSM volume name must be unique 
within the disk group. If the LSM volume has a file system or is part of an 
AdvFS domain, you must update the /etc/fstab and /etc/fdmn files. 


To rename an LSM volume, enter: 
# voledit rename old volume new volume 


Be sure to update the relevant files in the /etc directory. If this is not 
done and the system is rebooted, subsequent commands on a volume using 
its previous name will fail. 


5.4.9 Changing LSM Volume Permission, User, and Group Attributes 


By default, the device special files for LSM volumes are created with read 
and write permissions granted only to the owner. Databases or other 
applications that perform raw I/O might require device special files to have 
other settings for the permission, user, and group attributes. 


You must use LSM commands to change the permission, user, and group 

attributes for LSM volumes. The LSM commands ensure that settings for 
these attributes are stored in the LSM database, which keeps track of all 

settings for LSM objects. 


Do not change the permission, user, or group attributes by using the chmod, 
chown, or chgrp commands directly on the device special files associated 
with LSM volumes. These standard UNIX commands do not store the 
required values in the LSM configuration database. 


To change Tru64 UNIX user, group, and permission attributes, enter: 


# voledit [-g disk group] set \ 
user=username group=groupname mode=permission volume 


The following example changes the user, group, and permission attributes 
for an LSM volume called vol1: 


# voledit set user=new_user group=admin mode=0600 voll 


5.5 Managing Plexes 


The following sections describe how to use LSM commands to manage plexes. 


5.5.1 Displaying Plex Information 


You can display information about all plexes or about one specific plex. 
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5.5.1.1 Displaying General Plex Information 
To display general information for all plexes, enter: 
# volprint -pt 


Information similar to the following is displayed: 


Disk group: rootdg 


PL NAME VOLUME KSTATE STATE LENGTH LAYOUT NCOL/WID MODE 
pl tst-01 tst ENABLED ACTIVE 262144 CONCAT - RW 
pl tst-02 tst DETACHED STALE 262144 CONCAT = RW 
pl vol5-01 vol5 ENABLED ACTIVE 409696 RAID 8/32 RW 
pl vol5-02 vol5 ENABLED LOG 2560 CONCAT rs RW 


5.5.1.2 Displaying Detailed Plex Information 
To display detailed information about a specific plex, enter: 
# volprint -lp [plex] 


Information similar to the following is displayed: 


Disk group: rootdg 


Plex: pl 
info: len=500 
type: layout =CONCAT 


state: state=EMPTY kernel=DISABLED io=read-write 
assoc: vol=vl sd=dsk4-01 
flags: complete 


Plex: p2 
info: len=1000 
type: layout =CONCAT 


state: state=EMPTY kernel=DISABLED io=read-write 
assoc: vol=v2 sd=dsk4-02 
flags: complete 


Plex: vol_mir-01 
info: len=256 
type: layout=CONCAT 


state: state=ACTIVE kernel=ENABLED io=read-write 
assoc: vol=vol_mir sd=dsk2-01 
flags: complete 


Plex: vol_mir-02 
info: len=256 
type: layout=CONCAT 


state: state=ACTIVE kernel=ENABLED io=read-write 
assoc: vol=vol_mir sd=dsk3-01 
flags: complete 


Plex: vol_mir-03 
info: len=0 (sparse) 
type: layout =CONCAT 


state: state=ACTIVE kernel=ENABLED io=read-write 
assoc: vol=vol_mir sd=(none) 

flags: 

logging: logsd=dsk3-02 (enabled) 
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5.5.2 Adding a Data Plex 


You can add a data plex toa volume to create a mirror data plex. You cannot 
create a mirror data plex on a disk that already contains a data plex for 
the volume. 


The data from the original plex is copied to the added plex, and the plexes 
are synchronized. This process can take a long time depending on the size 
of the volume, so you should run the command in the background (using 
the & operator). 


Note 


Adding a data plex does not add a DRL plex tothe volume. It is 
highly recommended that volumes with mirror plexes have a 
DRL plex. See Section 5.5.3 for more information on adding a log 
plex to a volume. 


To add a data plex, enter: 


# volassist mirror volume [disk] & 


5.5.3 Adding a Log Plex 


You can add a log plex (DRL plex or RAID 5 log plex) toa volume that has 
mirrored data plexes or a RAID 5 data plex. However, if the volume is used 
for secondary swap, it should not have a DRL. You use the same command to 
add both DRL plexes and RAID 5 logs. 


To improve performance, the DRL plex should not be on the same disk as one 
of the volume’s data plexes. To ensure that LSM does not create a DRL plex 

on the same disk as a data plex, usethe volprint -ht command todisplay 
volume information to identify an LSM disk that is not part of the volume. 


To add a log plex toa volume, enter: 


# volassist addlog volume disk 


5.5.4 Moving Data to a New Plex 
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You can move the data from a striped or concatenated plex to a new plex to: 
« MovetheLSM volume onto disks with better performance. 


« MovetheLSM volume onto new plexes that use a different data layout 
type. For example, you can move data from a concatenated plex toa 
striped plex to improve performance. 


« MovetheLSM volume to different plexes temporarily so you can repair 
or replace disks in the original plex. 
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You can perform this operation only on volumes that use concatenated or 
striped plexes. You cannot move data from a concatenated or striped plex 
toa RAID 5 plex or froma RAID 5 plex to a concatenated or striped plex. 


For a move operation to be successful: 
¢« Theold plex must be an active part of an active volume. 


e« Thenew plex cannot be associated with another LSM volume and must 
be at least the same size as or larger than the original plex. 


Note 


If the new plex is larger than the original plex and the 
original plex contains a file system, the file system will not 
recognize and use the extra space after it is moved. You must 
recreate the file system on the new plex to take advantage of 
the extra space. 


To move data from one plex to another: 


1. Display the size of the plex you want to move: 
# volprint -ht volume 


Information similar to the following is displayed: 


Disk group: rootdg 


V NAME USETYPE KSTATE STATE LENGTH READPOL PREFPLEX 

PL NAME VOLUME KSTATE STATE LENGTH LAYOUT NCOL/WID MODE 
SD NAME PLEX DISK DISKOFFS LENGTH [COL/] OFF DEVICE MODE 
v  DataVo fsgen ENABLED ACTIVE 204800 SELECT > 

pl DataVol-01 DataVo ENABLED ACTIVE 204800 STRIPE 8/128 RW 
sd dsk0-0 DataVol-01 dsko 0 25600 0/0 dsko ENA 
sd dsk1-0 DataVol-01 dsk1l 0 25600 1/0 dsk1l ENA 
sd dsk2-01 DataVol-01 dsk2 0 25600 2/0 dsk2 ENA 
sd dsk3-0 DataVol-01 dsk3 0 25600 3/0 dsk3 ENA 
sd dsk4-0 DataVol-01 dsk4 0 25600 4/0 dsk4 ENA 
sd dsk6-01 DataVol-01 dsk6 65 25600 5/0 dsk6 ENA 
sd dsk7-01 DataVol-01 dsk7 0 25600 6/0 dsk7 ENA 
sd dsk8-0 DataVol-01 dsk8 0 25600 7/0 dsk8 ENA 
pl DataVol-02 DataVo ENABLED ACTIVE 204800 STRIPE 8/128 RW 
sd dsk10-01 DataVol-02 dsk10 0 25600 0/0 dsk10 ENA 
sd dsk11-01 DataVol-02 dsk11 0 25600 1/0 dsk11 ENA 
sd dsk12-01 DataVol-02 dsk12 0 25600 2/0 dsk12 ENA 
sd dsk13-01 DataVol-02 dsk13 0 25600 3/0 dsk13 ENA 
sd dsk14-01 DataVol-02 dsk14 0 25600 4/0 dsk14 ENA 
sd dsk15-01 DataVol-02 dsk15 0 25600 5/0 dsk15 ENA 
sd dsk18-01 DataVol-02 dsk18 0 25600 6/0 dsk18 ENA 
sd dsk19-01 DataVol-02 dsk19 0 25600 7/0 dsk19 ENA 
pl DataVol-03 DataVo ENABLED ACTIVE LOGONLY CONCAT - RW 
sd dsk6é-02 DataVol-03 dské 0 65 LOG dskeé ENA 


In this example, the volume has two striped data plexes of 204800 
sectors (100 MB). 
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2. Ensurethereis enough space on other LSM disks to move the plex’s 
data. 


3. Create a new plex with the characteristics you want. 
¢ For aconcatenated plex, see Section 4.2.1 
¢« For astriped plex, see Section 4.2.2 
¢« For astriped plex that uses disks on different buses, see Section 4.2.3 


4. Enter the following command line (set to run in the background) to 
attach the new plex to the volume and move the data from the old 
plex to the new plex, optionally removing the old plex upon successful 
completion of the move: 


# volplex [-o rm] mv old plex new plex & 


The volume remains active and usable during this operation. 


5.5.5 Reattaching a Plex 


If you removed a plex from a volume and did not recursively remove it and 
its objects, you can reattach it to the volume. 


To reattach a plex to a volume, enter: 


# volplex att volume plex 


5.5.6 Removing a Plex 


You can remove a plex from an LSM volume to reduce the number of plexes 
in a volume. 


Note 


The following restrictions apply: 


e« You cannot removea RAID 5 data plex from a volume, because 
that is the only data plex. However, you can remove a volume 
completely (Section 5.4.6). 


¢ |f the volume has mirror plexes and you remove all but one, 
the volume’s data is no longer redundant. 


¢ If you remove the DRL plex from a volume that has mirror 
plexes and the system fails, LSM will have to resynchronize 
the entire contents of the plexes when the system restarts. 


e If you remove the RAID 5 log plex from a volume that uses a 
RAID 5 plex and the system fails, LSM will have to read back 
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all the volume data, regenerate the parity for each stripe, and 
rewrite each stripe in the plex. 


To remove a data plex from a volume with mirror plexes: 


1. Dissociate the plex from its volume, and optionally remove the old plex 
after successful completion of the dissociation: 


# volplex [-o rm] dis plex 
2. If you did not use the option in step 1, remove the plex: 


# voledit -r rm plex 


Removing the plex also removes all associated subdisks in that plex. The 
disks remain under LSM control, and you can use them for other volumes 
or remove them from LSM control. 


To remove the log plex from a RAID 5 volume: 


1. Dissociate the log plex from the RAID 5 volume (using the -o force 
option): 


# volplex -o force dis log plex 
2. Remove the plex and its subdisks: 


# voledit -r rm log plex 


5.6 Managing Subdisks 


The following sections describe how to use LSM commands to manage 
subdisks. 


5.6.1 Displaying Subdisk Information 


You can display information about all subdisks or one specific subdisk. 


5.6.1.1 Displaying General Subdisk Information 
To display general information for all subdisks, enter: 
# volprint -st 


Information similar to the following is displayed: 


Disk group: rootdg 


SD NAME PLEX DISK DISKOFFS LENGTH [COL/]OFF DEVICE MODE 
sd dsk2-01 vol_mir-01 dsk2 0) 256 0) dsk2 ENA 
sd dsk3-02 vol_mir-03 dsk3 0) 65 LOG dsk3 ENA 
sd dsk3-01 vol_mir-02 dsk3 65 256 0) dsk3 ENA 
sd dsk4-01 pl dsk4 17 500 0 dsk4 ENA 
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sd dsk4-02 p2 dsk4 518 1000 0) dsk4 ENA 


5.6.1.2 Displaying Detailed Subdisk Information 
To display detailed information about a specific subdisk, enter: 
# volprint -1 subdisk 


The following example shows information about a subdisk called dsk12-01: 
Disk group: rootdg 


Subdisk: dsk12-01 


info: disk=dsk12 offset=0 len=2560 
assoc: vol=vol5 plex=vol5-02 (offset=0) 
flags: enabled 


device: device=dsk12 path=/dev/disk/dskl2g diskdev=82/838 


5.6.2 Joining Subdisks 


You can join two or more subdisks to form a single, larger subdisk. Subdisks 
can be joined only if they belong to the same LSM volume and occupy 
adjacent regions of the same disk. For a volume with striped plexes, the 
subdisks must bein the same column. The joined subdisk can have a new 
subdisk name or retain the name of one of the subdisks being joined. 


To join subdisks, enter: 


# volsd join subdiskl subdisk2 new_subdisk 


5.6.3 Splitting Subdisks 


You can divide a subdisk into two smaller subdisks. Once split, you can 
move the data in the smaller subdisks to different disks. This is useful 
for reorganizing volumes or for improving performance. The new, smaller 
subdisks occupy adjacent regions within the same region of the disk that 
the original subdisk occupied. 


You must specify a size for the first subdisk; the second subdisk consists of 
the rest of the space in the original subdisk. 


If the subdisk to be split is associated with a plex, both of the resultant 
subdisks are associated with the same plex. You cannot split a log subdisk. 


To split a subdisk and assign each subdisk a new name, enter: 
# volsd -s size split original subdisk new _subdisk1 new_subdisk2 


To split a subdisk and retain the original name for the first subdisk and 
assign a new name to the second subdisk, enter: 


# volsd -s size split original subdisk new _subdisk 
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5.6.4 Moving Subdisks 


You can move the datain subdisks toa different disk toimprove performance. 
The disk space occupied by the data in the original subdisk is returned tothe 
free space pool. 


Ensure that the following conditions are met before you move data in a 
subdisk: 


¢ Both source and destination subdisks must be the same size. 
¢« Thesource subdisk must be part of an active plex on an active volume. 
¢« The destination subdisk must not be associated with any other plex. 


¢ The destination subdisk must not be on a disk that contains another 
subdisk in use by the same volume. 


To move data from one subdisk to another, enter: 


# volsd mv source subdisk target _subdisk 


5.6.5 Removing a Subdisk 


You can remove a subdisk that is not associated with or needed by an LSM 
volume. Removing a subdisk returns the disk space to the free space pool 
in the disk group. To remove a subdisk, you must dissociate the subdisk 
from a plex, then remove it. 


To remove a subdisk: 

1. Display information about the subdisk to identify any volume or plex 
associations: 
# volprint -1 subdisk 


¢ |f the subdisk is associated with a volume, information similar to 
the following is displayed: 


Disk group: rootdg 


Subdisk: dsk9-01 


info: disk=dsk9 offset=0 len=2048 

assoc: vol=newVol plex=myplex (column=1 offset=0) 
flags: enabled 

device: device=dsk9 path=/dev/disk/dsk9g diskdev=82/646 


e |f the subdisk has no associations to any plex or volume, information 
similar to the following is displayed: 


Disk group: dgl 


Subdisk: dsk5-01 


info: disk=dsk5 offset=0 len=2046748 

assoc: vol=(dissoc) plex=(dissoc) 

flags: enabled 

device: device=dsk5 path=/dev/disk/dsk5g diskdev=79/390 
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2. Doone of the following to remove the subdisk: 
e |f the subdisk is associated with a volume, enter: 


# volsd -o rm dis subdisk 


¢ |fthesubdisk is not part of a volume and has no associations, enter: 


# voledit [-g disk group] rm subdisk 
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6 


Troubleshooting 


LSM helps you protect the availability and reliability of data but does not 

prevent I/O failure. LSM is simply another layer added tothe!/O subsystem. 
LSM depends on the underlying disk device drivers and system files to decide 
on the availability of individual disks and to manage and report any failures. 


This chapter describes how totroubleshoot common LSM problems, describes 
tools that you can use tolearn about problems, and offers possible solutions. 


The hot-spare feature provides the best protection for volumes that use 
mirror plexes or a RAID 5 plex. When enabled, the hot-spare feature allows 
LSM to automatically relocate data from a failed disk in a volume that uses 
either a RAID 5 plex or mirrored plexes. LSM writes the data toa designated 
spare disk, or to free disk space, and sends you mail about the relocation. See 
Section 3.4.4.1 for more information about enabling the hot-spare feature. 


6.1 Monitoring LSM 


You can use LSM commands to monitor the status of LSM objects. By doing 
so, you can understand how LSM works under normal conditions and 
watch for indication that an LSM object might need adjustments before a 
problem arises. 


6.1.1 Monitoring LSM Events 


By default, LSM uses Event Manager (EVM) software to log events. 
The events that LSM logs are defined in the EVM template called 
/usr/share/evm/templates/sys/lsm.volnotify.evt. 


You can select, filter, sort, format, and display LSM events using EVM 
commands or the graphical event viewer, which is integrated with the 
SysMan Menu and SysMan Station. 


To display a list of logged LSM events, enter: 


# evmget -f "[name *.volnotify]" | evmshow -t "@timestamp @@" 


To display LSM events in real time, enter: 


# evmwatch -£ "[name *.volnotify]" | evmshow -t "@timestamp @@" 


See the EvM(5) reference page for more information about EVM. 
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6.1.2 Monitoring Read and Write Statistics 


You can use the volstat command to view and reset: 
¢ Thenumber of successful or failed read and write operations 
¢ Thenumber of blocks read from and written to 


¢ Theaverage time spent on read and write operations. This time reflects 
the total time it took to complete a read or write operation, including the 
time spent waiting in a queue on a busy device. 


Table 6-1 describes the some of the options that you can use with the 
volstat command. 


Table 6-1: Common volstat Command Options 


Option Displays 

-v Volume statistics 

-p Plex statistics 

-s Subdisk statistics 

-d LSM disk statistics 

-i seconds The specified statistics continuously in the 


interval specified (in seconds). 


For information on all the volstat options, see the volstat(8) reference 
page. 


Note 


In a duster environment, the volstat command displays 
statistics for the system on which the command is entered and 
does not provide statistics for all the systems within a cluster. 


6.1.2.1. Displaying Read and Write Statistics 


To display read and write statistics for LSM objects, enter: 


# volstat [-g disk group] -vpsd [-i number of seconds| 
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Information similar to the following is displayed: 


OPERATIONS 


TYP NAME 


dm 
dm 
dm 
dm 


Oo Qa 


a a 


aa 


none oT H HO <Dd 


Q 


rua 


dské 
dsk7 
dsk9 
dsk10 
dsk12 
vi 
v1-01 
dsk6-01 
v2 
v2-01 
dsk7-01 
dsk12-01 
v2-02 
dsk9-01 
dsk10-01 
v2-03 
dsk6-02 


READ 
3 
0) 

688 


29962 


0 
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WRITE 
82 
725 
37 
0) 
29962 
72 
72 
72 
37 
37 
37 
0 
37 
37 
0) 
6 
6 


READ 
40 
0) 
175872 
7670016 
0 
40 
40 
40 
0) 


ecoooaoao0a”d0 


BLOCKS 


WRITE 


62561 
176464 
592 

0) 
7670016 
62541 
62541 
62541 
592 
592 
592 

0 

592 
592 

0) 

12 

12 


TheLSM objects are identified as follows: 


6.1.2.2 Displaying Failed Read and Write Statistics 


dm - Disk media name (LSM name for the disk) 


vol - Volume name 


pl - Plex name 


sd - Subdisk name 


To display failed I/O statistics, enter: 


# volstat [-g disk group] -f cf LSM object 


AVG TIME (ms) 
READ WRITE 
Bilis 
16. 


SOOO OO OO Oma AAO KR WO ow 
COO OOOOOOMO ODO OOW SD 


Be) 


Information similar to the following is displayed: 


TYP NAME 
vol testvol 


CORRECTED 
READS WRITES 
al 0 


FAILED 


READ 


Ss 
0) 


WRITE 


Ss 
0 
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iS) 


LSM corrects read failures for mirror plexes or a RAID 5 plex, because these 
plexes provide data redundancy. 


6.1.3 Monitoring LSM Object States 


The kernel and LSM monitor the state of LSM objects. 
To display the state of LSM objects, enter: 


# volprint [-g disk group] 


Information similar to the following is displayed: 


Disk group: dgl 
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TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTILO PUTILO 


dg dgl1 dg1 - = a = - = 
dm dsk1 dsk1 = 2046748 - S oe oa 
dm dsk2 dsk2 - 2046748 - - - - 
dm dsk4 dsk4 - 2046748 - = - = 
dm dsk5 dsk5 = 2046748 - = = = 
v vol-test fsgen ENABLED 2048 ce ACTIVE - = 
pl vol-test-01 vol-test ENABLED 2048 i ACTIVE 3 = 
sd dsk1-01 vol-test-01 ENABLED 1024 0 = = = 
sd dsk2-01 vol-test-01 ENABLED 1024 0 - - - 
pl vol-test-02 vol-test ENABLED 2048 iS ACTIVE a = 
sd dsk4-01 vol-test-02 ENABLED 1024 0 S = = 
sd dsk5-01 vol-test-02 ENABLED 1024 0 S é = 


The KSTATE column shows the kernel state of the LSM object. The STATE 
column shows the LSM state of the LSM object. The LSM objects are 
identified as follows: 


* dg - Disk group name 

¢ dm- Disk media name (LSM name for the disk) 
« v- Volume name 

* pl - Plex name 

¢ sd - Subdisk name 


6.1.3.1. Kernel States 


TheLSM kernel state indicates the accessibility of the LSM object as viewed 
by the kernel. Table 6-2 describes kernel states for LSM objects. 


Table 6—2: LSM Volume Kernel States (KSTATE) 


Kernel State Means 

ENABLED The LSM object is accessible and read and write 
operations can be performed. 

DISABLED The LSM object is not accessible. 

DETACHED Read and write operations cannot be performed, but 


device operations are accepted. 


6.1.3.2 LSM States 


LSM monitors the states of volumes, plexes, and subdisks. 


« A volume has an LSM state (Table 6-3). The meaning of some volume 
states differs depending on the kernel state (K STATE). 


¢« A plex has an LSM state (Table 6-4). 
e A subdisk has an LSM state (Table 6-5). 
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Table 6-3: LSM Volume States (STATE) 


State Means Kernel State 

EMPTY The volume contents arenot DISABLED 
initialized. 

CLEAN The volume is not started. DISABLED 


¢ For mirrored volumes, 
plexes are synchronized. 


¢ For RAID 5 volumes, 
parity is good and stripes 
are consistent. 


ACTIVE The volume was started or was ENABLED 
in use when the system was DISABLED if RAID 5 parity 
rebooted. synchronization is not 


guaranteed or if mirror plexes are 
not guaranteed to be consistent. 


SYNC The system is resynchronizing ENABLED if the mirror plexes 
mirror plexes or RAID 5 parity. or RAID 5 parity are being 

resynchronized. 
DISABLED if the mirror plexes 
or RAID 5 parity were being 
resynchronized when the system 
rebooted and therefore still need 
to be synchronized. 


NEEDSYNC The volume requires a 
resynchronization operation 
the next time it starts. 


REPLAY A RAID 5 volume is in a 
transient state as part of 
a log replay. A log replay 
occurs when it is necessary to 
reconstruct data using parity 
and data. 


Table 6—4: LSM Plex States 
State Means 


EMPTY The plex is not initialized. This state is also set when 
the volume state is EMPTY. 


CLEAN The plex was running normally when the volume was 
stopped. The plex was enabled without requiring recovery 
when the volume was started. 


ACTIVE The plex is running normally on a started volume. 
LOG The plex is a DRL or RAID 5 log plex for the volume. 
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Table 6—4: LSM Plex States (cont.) 


State 


Means 


STALE 


1OFAIL 


OFFLINE 
SNAPATT 


SNAPDONE 


SNAPTMP 


SNAPDIS 


TEMP 


TEMPRM 


TEMPRMSD 


The plex was detached, either by the volplex det command or 
by an 1/O failure. STALE plexes are reattached automatically 
by volplex att when a volume starts. 


The vold daemon places an ACTIVE plex in the l|OFAIL state 
when it detects an error. The plex is disqualified from the 
recovery selection process at volume start time, ensuring that 
LSM uses only valid plexes for recovery. A plex marked IOFAIL 
is recovered if possible during a resynchronization. 


The plex was disabled by the volmend off command. 


This is a snapshot plex that is attached by the volassist 
snapstart command. When theattach is complete, the state for 
the plex is changed to SNAPDONE. If the system fails before the 
attach completes, the plex and all of its subdisks are removed. 


This is a Snapshot plex created by volassist snapstart 
command that is fully attached. You can turn a plex in this 
state into a snapshot volume with the volassist snapshot 
command. If the system fails before the attach completes, 
the plex and all of its subdisks are removed. 


This is a snapshot plex that is attached by the volplex 
snapstart command. When the attach is complete, the state 
for the plex changes to SNAPDIS. If the system fails before the 
attach completes, the plex is dissociated from the volume. 


This is a snapshot plex created by the volplex snapstart 
command that is fully attached. You can turn a plex in this 
state into a snapshot volume with the volplex snapshot 
command. If the system fails before the attach completes, 
the plex is dissociated from the volume. 


This is a plex that is associated and attached to a volume with 
the volplex att command. If the system fails before the 
attach completes, the plex is dissociated from the volume. 


This is a plex that is being associated and attached toa volume 
with the volplex att command. If the system fails before 
the attach completes, the plex is dissociated from the volume 
and removed. Any subdisks in the plex are kept. 


This is a plex that is being associated and attached toa 
volume with the volplex att command. If the system 
fails before the attach completes, the plex and its subdisks 
are dissociated from the volume and removed. 
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Table 6—5: LSM Subdisk States 
State Means 


REMOVED The subdisk (which might encompass the entire LSM disk) was 
removed from the volume, disk group, or from LSM control. 


RECOVER Thesubdisk must be recovered. Use the volrecover command. 


6.2 Missing or Altered sysconfigtab File 


During the boot disk encapsulation procedure, LSM adds the following 
entries to the /etc/sysconfigtab file to enable the system to boot off 
the LSM root volume: 


lsm: 
lsm_rootdev_is_ volume=1 


If this file is deleted or the LSM-specific entries are deleted, the system will 
not boot. If this happens, do the following: 


1. Boot the system interactively: 


>>> boot -fl i 


Enter kernel name option_1 ... option_n: vmunix 


2. Reset the LSM entries as follows: 


1sm: 
lsm_rootdev_is volume=1 


6.3 LSM Startup and Command Problems 


LSM requires that the vold and voliod daemons be running. These 
daemons are normally started automatically when the system boots. I f these 
daemons are not running, the most obvious problems you might notice are 
that LSM commands fail to complete or do not respond as expected, which is 
an indication that LSM did not correctly start up. 


The following sections describe how to check if the daemons are running 
and how to correct problems. 
6.3.1 Checking the vold Daemon 
To determine the state of the vold daemon, enter: 
# voldctl mode 


Table 6-6 shows messages that might display, what the message means, and 
the commands you should enter if vold is disabled or not running. 
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Table 6-6: vold Messages and Solutions 


Message Status Enter 

Mode: enabled Running and enabled —_ 

Mode: disabled Running but disabled voldctl enable 
Mode: not-running Not running vold 


See the vold(8) reference page for more information on the vold daemon. 


6.3.2 Checking the voliod Daemon 


The correct number of voliod daemons automatically start when LSM 
starts. Typically several voliod daemons are running at all times. You 
should run at least one voliod daemon for each processor on the system. 


To display the number of the voliod daemons running, enter: 
# voliod 


Information similar to the following is displayed: 


0 volume I/O daemons running 


This is the only method for checking on voliod daemons, because the 
voliod processes are kernel threads and do not display in the output of 
the ps command. 


If nO voliod daemons are running, or if you want to change the number 
of daemons, enter the following command where n is the number of 1/O 
daemons to start: 


# voliod set n 


Set the number of LSM 1/O daemons to two or the number of central 
processing units (CPUs) on the system, whichever is greater. 


Verify the change by entering the following command: 
# voliod 


Information similar to the following is displayed: 


2 volume I/O daemons running 


See the voliod(8) reference page for more information on the voliod 
daemon. 


6.4 Solving Problems with LSM Volumes 


The following sections describe how to solve common LSM volume problems. 


6-8 Troubleshooting 


6.4.1 Insufficient Space to Create a Volume 


When you use the volassist command to create a volume with a striped 
plex, you might receive an error message indicating insufficient space for the 
volume even though you know there is enough space available. 


Thevolassist command rounds up the length you specify on the command 
line to a multiple of the data unit size of 64 KB by default, or the stripe 
width you specified, and then divides the total by the number of disks 
available to make the column. The smallest disk in the disk group limits 
the data unit size. 


For example, you have two disks with differing free space in the disk group 


called dgl1: 

# voldg -g dgl free 

GROUP DISK DEVICE TAG OFFSET LENGTH FLAGS 
dgl dsk1l dsk1l dsk1l 0 2049820 - 

dgl dsk2 dsk2 dsk2 0 2047772 - 


The total free space on these two disks is 4097592. You tried to createa 
volume with a striped plex, with a length of 4095544, or about 2 GB, which 
is less than the total space available: 


# volassist -g dgl make NewVol 4095544 layout=stripe 


volassist: adjusting length 4095544 to conform 
to a layout of 2 stripes 128 blocks wide 
volassist: adjusting length up to 4095744 blks 


volassist: insufficient space for a 4095744 block long volume in stripe, 
contiguous layout 


The command returned an error message indicating insufficient space, 
because volassist rounded up the length you specified to an even multiple 
of the data unit size of 64 KB (128 blocks) and divided that number by the 
number of disks (2). The result was larger than the space available on the 
smaller disk: 4095744 / 2 =2048796. 


If your volume does not need to be precisely the size you specified, you 
can retry the command with a length that works with the data unit size 
and the number of disks. For example, multiply the size of the smallest 
free space by the number of disks: 2047772 * 2 = 4095488. Use this value 
in the command line: 


# volassist -g dgl make NewVol 4095488 layout=stripe 


If the volume you requireis larger than the total free space in the disk group, 
or if the volume must be exactly the size you specify, you must add more (or 
larger) disks to that disk group. See Section 5.2.3 for more information on 
adding disks to a disk group. 
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6.4.2 Starting a Disabled Volume 


If you cannot mount a file system or open an LSM volume, the LSM volume 
might not be started. 


To determine whether or not the LSM volume is started, enter: 
# volinfo [-g disk group] volume 


The following output shows the condition of several volumes: 


vol bigvol fsgen Startable 
vol vol2 fsgen Started 
vol brokenvol gen Unstartable 


LSM volumes can have the following conditions: 
* Started - Thevolume is enabled and running normally. 


* Startable - Thevolumeis not enabled, and at least one plex has a state 
of ACTIVE or CLEAN, indicating that the volume can be restarted.? 


To start a startable volume, enter: 
# volume [-g disk group] start volume 


* Unstartable - The volumeis not enabled and has a problem that you 
must resolve before you can start the volume. For example, a disk might 
have failed. 


- Ifthevolumeis redundant (that is, it uses mirror plexes or a RAID 5 
plex), see Section 6.5.5 for information on replacing failed disks and 
recovering the volumes. 


- Ifthevolume is not redundant, see Section 6.4.3. 


6.4.3 Recovering Unstartable Nonredundant Volumes 


Nonredundant volumes are those that use a single plex that is either 
concatenated or striped. If a disk in the plex fails, the volume will be 
unstartable. 


You can display the volume's condition by entering: 
# volinfo -p 


Information similar to the following is displayed: 


vol tst fsgen Unstartable 
plex tst-01 NODEVICE 


1 Normally, volumes will not bein this state unless you manually created a volume (not using 
the volassist command, which starts the new volume automatically), or you did something 
that disabled the volume, such as removing a plex. All startable volumes are started when 
the system reboots. 
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To recover the volume: 


1. Ifthe disk is usable, continue with step 2. If the disk has failed, replace 
the disk: 


a. 


Identify the disk media name of the failed disk using one of the 
following commands: 


¢ Todisplay all disk, disk group, and volume information and the 
status of any volumes that are affected by the failed disk, enter: 


# volprint -Aht 
¢ Todisplay only the disk information, enter: 
# volprint -Adt 
Remove the failed disk and retain the disk media records: 
# voldg [-g disk group] -k rmdisk dm name 
Remove the disk access records, using the disk access name: 
# voldisk rm da_name 
Physically remove the failed disk and replace it with the new disk. 
Prompt the system to scan for the new disk: 
# hwmgr -scan scsi 


See the hwmgr(8) reference page for more information on the hwmgr 
command. 


Initialize the disk for LSM, using the disk access name: 


# voldisk -f init da name 


Optionally (but recommended), create a backup copy of the new 
disk’s disk label information: 


# disklabel da _name > file 

Add the new disk tothe applicable disk group, assigning a disk 
media name to the disk access name: 

# voldg [-g disk group] -k adddisk dm name=da_name 
Verify that volume’s plex state has changed to RECOVER: 


# volinfo -p 
vol tst fsgen Unstartable 
plex tst-01 RECOVER 


2. Set the plex state to STALE: 


# volmend fix stale plex 
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LSM has internal state restrictions that require a plex to change states 
in a specific order. A plex must be STALE before it can be marked 
CLEAN. 


3. Set the plex state to CLEAN: 


# volmend fix clean plex 


4. Start the volume: 


# volume start volume 
The volume is now running and usable but contains invalid data. 
5. Depending on what was using the volume, do one of the following: 


e |f the volume was used by a file system, recreate the file system on 
the volume, and mount the file system. See Section 4.3 for more 
information on configuring a volume for a file system. 


If you have a backup of the data, restore the volume using the 
backup. See Section 5.4.3 for more information on restoring a 
volume from backup. 


e If you have no backup and the volume was used by an application 
such as a database, refer to that application’s documentation for 
information on restoring or recreating the data. 


6.4.4 Recovering Volumes with Mirror Plexes 


Volumes with mirror plexes are less vulnerable than volumes with a single 
(nonmirrored) plex, but if disks in all the plexes fail, the volume’s state 
will be Unstartable. 


There are three possible scenarios for the failure and recovery of volumes 
with mirror plexes: 


¢« Datain all plexes is known to be bad or is unknown. See Section 6.4.4.1. 


« One plex is known to be valid, and you want to use that plex to restore 
the others. See Section 6.4.4.2. 


¢ Data in all the plexes is known to be valid, but you have lost all copies 
of the configuration database. (All disks containing copies failed.) See 
Section 6.4.4.3. 


6.4.4.1. Recovering a Volume with No Valid Plexes 


If disks in multiple plexes of a volume failed, all the volume’s data might 
be corrupt or suspect. Recovering a volume from a multiple disk failure 
requires that you restore the data from backup. 
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To recover a volume with no valid plexes: 


1. 


Set all the plexes in the volume to CLEAN: 

# volmend fix clean plexl1 plex2 ... 

Start the volume: 

# volume start volume 

Depending on what was using the volume, do one of the following: 


¢ If the volume was used by a file system, recreate the file system on 
the volume, and mount the file system. See Section 4.3 for more 
information on configuring a volume for a file system. 


If you have a backup of the data, restore the volume using the 
backup. See Section 5.4.3 for more information on restoring a 
volume from backup. 


¢ If you have no backup and the volume was used by an application 
such as a database, refer to that application’s documentation for 
information on restoring or recreating the data. 


6.4.4.2 Recovering a Volume with One Valid Plex 


If you know that one plex in a volume contains valid data, you can use that 
plex to restore the others. 


To recover a volume with one valid plex: 


1. 


Set the valid plex’s state to CLEAN: 

# volmend fix clean valid plex 

Set the state of all the other plexes to STALE: 

# volmend fix stale stale plexl1 stale plex2 ... 


Start the volume and initiate the resynchronization process in the 
background: 


# volrecover -sb volume 


6.4.4.3 Recovering a Volume After Loss of Configuration Database 


The following procedure requires a backup copy of the configuration database 
(created by the volsave command, as described in Section 5.3.1) restored 
by the volrestore command. See Section 5.3.2 for more information on 
restoring the configuration database. You should have a high degree of 
confidence that the volume data is still valid. 


To recover a volume after restoring the configuration database: 


1. 


Set all plexes in the volume to CLEAN: 
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2. 


# volmend fix clean plexl1 plex2 ... 
Start the volume: 


# volume start volume 


6.4.5 Recovering Volumes with a Failed RAID 5 Plex 


Volumes that use a RAID 5 plex are designed to remain available when one 
disk fails. However, if two disks in the data plex fail, the entire volume 
is compromised. 


If hot-sparing is enabled at the time of a disk failure, system 
administrator intervention is not required (unless there is no suitable 
disk space available for relocation). Hot-sparing is triggered by the disk 
failure, and you are notified of the failure by electronic mail. Hot-sparing 
automatically attempts to relocate the subdisks of a failing RAID 5 plex. 
After relocation takes place, the hot-sparing daemon (volspared) also 
initiates a parity resynchronization. 


In the case of a failing RAID 5 log plex, relocation occurs only if the log 
plex is mirrored; volspared then initiates a mirror resynchronization 
to recreate the RAID 5 log plex. 


If hot-sparing is disabled at the time of a failure, you might need to 
initiate a resynchronization or recovery. 


There are three possible scenarios for the failure and recovery of volumes 
with a RAID 5 plex: 


Within the data plex, a disk in one column fails. See Section 6.5.5 for 
more information on replacing a failed disk and recovering the volume. 


Within the data plex, disks in two or more columns fail. See 
Section 6.4.5.1. 


Within the log plex, a disk fails, or the log plex becomes detached. See 
Section 6.4.5.2. 


6.4.5.1 Recovering a RAID 5 Plex from Multiple Disk Failures 


If disks in two or more columns of a RAID 5 data plex fail, LSM cannot use 
the remaining data (if any) and parity to reconstruct the missing data. You 
must restore the data from backup. 


To restore the volume: 


1. 


If the disk is usable, continue with step 2. If the disk has failed, replace 
the disk: 


a. Identify the disk media name of the failed disk using one of the 
following commands: 
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¢ Todisplay all disk, disk group, and volume information, and the 
status of any volumes that are affected by the failed disk, enter: 


# volprint -Aht 
¢ Todisplay only the disk information, enter: 
# volprint -Adt 
Remove the failed disk and retain the disk media records: 
# voldg [-g disk group] -k rmdisk dm name 
Remove the disk access records, using the disk access name: 
# voldisk rm da_name 
Physically remove the failed disk and replace it with the new disk. 
Scan for the new disk: 
# hwmgr -scan scsi 


See the hwmgr(8) reference page for more information on the hwmgr 
command. 


Initialize the disk for LSM, using the disk access name: 
# voldisk -f£ init da_name 


Optionally (but recommended), create a backup copy of the new 
disk’s disk label information: 


# disklabel da _name > file 


Add the new disk to the applicable disk group, assigning a disk 
media name to the disk access name: 


# voldg [-g disk group] -k adddisk dm name=da_name 
Verify that the volume’s plex state has changed to RECOVER: 


# volinfo -p 
vol tst fsgen Unstartable 
plex tst-01 RECOVER 


Stop the volume: 


# volume stop volume 


Set the RAID 5 data plex state to EMPTY: 


# volmend -o force fix empty volume 


Setting the plex state to EMPTY causes LSM to recalculate the parity 
when you restart the volume in the next step. 


Start the volume. The process of recalculating the parity can takea 
long time; you can run this operation in the background to return the 
system prompt immediately: 
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# volume [-o bg] start volume 


The volume becomes usable even while the parity regeneration is 
underway. If users access a region of the volume that has not yet had its 
parity recalculated, LSM recalculates the parity for the entire stripe that 
contains the accessed data before honoring the read or write request. 


Depending on what was using the volume, do one of the following: 


e |f the volume was used by a file system, recreate the file system on 
the volume, and mount the file system. See Section 4.3 for more 
information on configuring a volume for a file system. 


If you have a backup of the data, restore the volume using the 
backup. See Section 5.4.3 for more information on restoring a 
volume from backup. 


e If you have no backup, and the volume was used by an application 
such as a database, refer to that application’s documentation for 
information on restoring or recreating the data. 


6.4.5.2 Recovering a RAID 5 Log Plex 


A disk containing a RAID 5 log could experience a failure. This has no direct 
effect on the operation of the volume; however, the loss of all RAID 5 logs on 
a volume makes the volume vulnerable to a complete failure. 


The following output from the volprint command shows a failure within 
a RAID 5 log plex. The plex state is BADLOG, and the RAID 5 log plex 
vol5-02 has failed. 


Disk 


group: 


V NAME 
PL NAME 
SD NAME 


voovo 
pl vo 
sd ds 
sd ds 
sd ds 
sd ds 
sd ds 
sd ds 
sd ds 
sd ds 
pl vo 
sd ds 


ARS 
15-01 
K3-01 
k4-01 
k5= 02: 
k6-O01 
kK7-O1 
kK8-O1 
K9-O1 
k10-01 
15-02 
k11-01 


rootdg 


USETYPE 
VOLUME 
PLEX 


raids 


vo 


5 

5-01 
5-01 
5-01 
5-01 
5-01 
5-01 
5-01 
5-01 
5 

5-02 


KSTATE 
KSTATE 


DI 


ENABLED 
ENABLED 


ds 
ds 
ds 
ds 
ds 
ds 
ds 
ds 


SK 


k3 
k4 
k5 
k6 
kK7 
k8 
k9 
k10 


STATE 
STATE 
DISKOFFS 


ACTIVE 
ACTIVE 


ooo moomoo) 


0 


DISABLED BADLOG 


ds 


kK11 


0 


LENGTH 
LENGTH 
LENGTH 


409696 
409696 
58528 
58528 
58528 
58528 
58528 
58528 
58528 
58528 
2560 
2560 


READPOL 
LAYOUT 
[COL/] OFF 


RAID 
RAID 
0/0 
1/0 
2/0 
3/0 
4/0 
5/0 
6/0 
7/0 
CONCAT 
0 


PREFPLEX 
NCOL/WID 
DEVICE 


8/32 
dsk3 
dsk4 
dsk5 
dsk6é 
dsk7 
dsk8 
dsk9 
dsk10 


MODE 
MODE 


RW 
ENA 
ENA 
ENA 
ENA 
ENA 
ENA 
ENA 
ENA 
RW 
RMOV 


RAID 5 log plexes might havea state of DETACHED due to disk failures. 
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To recover a RAID 5 log plex: 


1. Ifthe disk is usable but the log plex is detached, continue with step 2. If 
the disk has failed, replace the disk: 


a. 


Identify the disk media name of the failed disk using one of the 
following commands: 


¢ Todisplay all disk, disk group, and volume information and the 
status of any volumes that are affected by the failed disk, enter: 


# volprint -Aht 
¢ Todisplay only the disk information, enter: 
# volprint -Adt 
Remove the failed disk and retain the disk media records: 
# voldg [-g disk group] -k rmdisk dm name 
Remove the disk access records, using the disk access name: 
# voldisk rm da_name 
Physically remove the failed disk and replace it with the new disk. 
Scan for the new disk: 
# hwmgr -scan scsi 


See the hwmgr(8) reference page for more information on the hwmgr 
command. 


Initialize the disk for LSM, using the disk access name: 


# voldisk -f init da name 


Optionally (but recommended), create a backup copy of the new 
disk’s disk label information: 


# disklabel da _name > file 

Add the new disk tothe applicable disk group, assigning a disk 
media name to the disk access name: 

# voldg [-g disk group] -k adddisk dm name=da_name 
Verify that the volume’s plex state has changed to RECOVER: 


# volinfo -p 
vol tst fsgen Unstartable 
plex tst-01 RECOVER 


2. Reattach the log plex to the volume: 


# volplex att volume log plex 
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6.4.6 Checking the Status of Volume Resynchronization 


If the system fails and reboots, LSM automatically recovers all volumes that 
were running normally at the time of the failure. 


¢ For volumes that use mirror plexes and havea DRL plex, this involves 
resynchronizing all the dirty regions. 


¢ For volumes that usea RAID 5 plex and havea RAID 5 log plex, this 
involves replaying the log plex to complete any outstanding writes. 


Configuring redundant volumes with DRLs and RAID 5 log plexes is the 
recommended method to speed the recovery of volumes after a system failure. 
Under normal circumstances, the recovery happens so quickly that there is 
no noticeable effect (such as performance lag) once the system is running 
again. However, if the volume had no log, the resynchronization can take a 
long time (minutes to hours, or longer) depending on the size of the volume. 


You can display the status of the volume resynchronization in progress 
to determine how long it will take. (You cannot check the status of plex 
resynchronization, which occurs when you replace a failed disk or add a 
new plex to a volume; the volprint command does not have access to 
that information. However, in these cases, the volume is usable while the 
resynchronization occurs.) 


To determine the time remaining for a volume resynchronization in progress: 


1. Check the read/write flags for the volume to see the current recovery 
offset value: 
# volprint -vl volume | grep flags 
Information similar to the following is displayed: 
flags: open rwback (offset=121488) writeback 
2. Check again after some time has passed (120 seconds is ample) to see 
how far the recovery has progressed: 
# sleep 120 ; volprint -vl volume | grep flags 
Information similar to the following is displayed: 
flags: open rwback (offset=2579088) writeback 


3. Calculate the rate of progress by dividing the difference between the 
offsets by the time that passed between the two checks. For example, in 
120 seconds the resynchronization had completed 2457600 sectors. Each 
second, approximately 20480 sectors (10 MB) were resynchronized. 


4. Multiply the resynchronization rate by the size of the volume, in 
sectors. This indicates the approximate amount of time a complete 
resynchronization will take. For example, at a rate of 20480 sectors 
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per second, a volume that is 200 GB will take about five and a half 
minutes to resynchronize. 


The actual time required can vary, depending on other I/O loads on the 
system and whether the volume or the system experiences additional 
problems or failures. 


6.4.7 Clearing Locks on LSM Volumes 


When LSM makes changes to an object’s configuration, LSM locks the 
object until the change is written. If a configuration change terminated 
abnormally, there might still be a lock on the object. 


To determine if an object is locked, enter: 

# volprint [-g disk group] -vh 

In the information displayed, the lock appears in the TUTILO column. 
To clear the lock, enter: 

# volmend [-g disk group] clear tutil0 object ... 


You might need to restart the volume. See Section 5.4.4. 


6.5 Solving Disk Problems 


The following sections describe troubleshooting procedures for failing and 
failed disks, including the boot disk. 


6.5.1 Checking Disk Status 


Disks can experience transient errors for a variety of reasons, such as when 
a power supply suffers a surgeor a cable is accidentally unplugged. You can 
check the status of disks through the output of the volprint and voldisk 
commands. 


To see the LSM status of a disk, enter: 

# voldisk list 

To check the usability of a disk, enter: 

# voldisk check disk 

Information similar to the following is displayed: 
dsk5: Okay 


The voldisk command validates the usability of the given disks by testing 
whether LSM can read and write the disk header information. A disk is 
considered usable if LSM can write and read back at least one of the disk 
headers that are stored on the disk. If a disk in a disk group is found to be 
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unusable, it is detached from its disk group and all subdisks stored on the 
disk become invalid until you replace the physical disk or reassign the disk 
media records to a different physical disk. 


Note 


Because an LSM nopriv disk does not contain a disk header, a 
failed nopriv disk might continue to be considered okay and 
usable. 


6.5.2 Recovering a Stale Subdisk 


Like parity resynchronization, stale subdisk recovery is usually done when 
the volume starts. However, it is possible that: 


e« Therecovery process might get killed. 
¢ Thevolume might be started with an option to prevent subdisk recovery. 


¢ Thedisk on which the subdisk resides might have been replaced without 
any recovery operations being performed. 


To recover a stale subdisk in a volume, enter: 
# volume recover volume subdisk 


To recover all stale subdisks in a volume, enter the same command without 
specifying a subdisk: 


# volume recover volume 


6.5.3 Recovering Volumes After a Temporary Disk Failure 
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If adisk had atemporary failure but is not damaged (for example, the disk 
was removed by accident, a power cable was disconnected, or some other 
recoverable problem occurred) and the system was not rebooted, you can 
recover the volumes on that disk. (LSM automatically recovers volumes 
when the system is rebooted.) 


To recover from a temporary disk failure: 


1. Makesure the disk is back on line and accessible; for example: 
e Check that the disk is firmly snapped into the bay. 
e« Reconnect any loose cables. 
¢ Perform any other checks appropriate to your system. 

2. Scan for all known disks to ensure the disk is available: 


# voldctl enable 
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3. 


Recover the volumes on the disk: 


# volrecover -sb 


6.5.4 Moving a Volume Off a Failing Disk 


Often a disk has recoverable (soft) errors before it fails completely. If a disk 
is experiencing an unusual number of soft errors, move the volume off the 
disk and replace it. 


Note 
To replace a failed boot disk, see Section 6.5.6.1. 


To move a volume off a failing disk: 


1. 


Identify the size of the volume on the failing disk: 

# volprint [-g disk group] -ht [volume] 

Ensure there is an equal amount of free space in the disk group: 
# voldg [-g disk group] free 

If there is not enough space, add a new disk. See Section 4.1.2. 


Move the volume to a disk other than the failing disk, as specified by 
the ! operand. You do not need to specify a target disk. 


# volassist [-g disk group] move volume !disk 


See Section 6.5.5 for information on replacing a failed disk. 


6.5.5 Replacing a Failed Disk 


When a disk that was in use by LSM fails completely and its state becomes 
DETACHED, you must: 


1. 


Replace the disk with a new disk. For best results, replace a failed disk 
with the same or similar type of disk. 


Recover the volumes that used the failed disk. 


Note 
To replace a failed boot disk, see Section 6.5.6.1. 


To replace a failed disk: 


a. Identify the disk media name of the failed disk using one of the 
following commands: 
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¢ Todisplay all disk, disk group, and volume information, and the 
status of any volumes that are affected by the failed disk, enter: 


# volprint -Aht 
¢ Todisplay only the disk information, enter: 
# volprint -Adt 
b. Remove the failed disk and retain the disk media records: 
# voldg [-g disk group] -k rmdisk dm name 
c. Removethe disk access records, using the disk access name: 
# voldisk rm da_name 
Physically remove the failed disk and replace it with the new disk. 
Scan for the new disk: 
# hwmgr -scan scsi 


See the hwmgr(8) reference page for more information on the hwmgr 
command. 


f. Label the new disk, by doing one of the following: 


¢ If available, use the file containing the failed disk’s disk label 
information (Section 4.1.3): 


# disklabel -R da name auto file 
¢ If nodisk label file is available, enter: 
# disklabel -rwn da name 
g. Initialize the disk for LSM, using the disk access name: 
# voldisk -f init da_ name 


Optionally (but recommended), create a backup copy of the new 
disk’s disk label information: 


# disklabel da_name > file 


h. Add the new disk tothe applicable disk group, assigning a disk 
media name to the disk access name: 


# voldg [-g disk group] -k adddisk dm name=da_name 
2. Torecover the volumes that used the failed disk: 


a. Useoneof the following methods to recover the volume data: 


e |fthevolume uses mirror plexes or a RAID 5 plex, start the plex 
resynchronization (as a background task): 


# volrecover -sb volume 
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e Ifthe volume is nonredundant, restore the volume data from 
backup. 


3. Optionally, verify the volume is started: 


# volinfo 


Information similar to the following is displayed: 


home fsgen Started 
finance fsgen Started 
mkting fsgen Started 
src fsgen Started 


6.5.6 Recovering from a Boot Disk Failure 


When the boot disk is encapsulated into an LSM volume with mirror plexes, 
failures occurring on the original boot disk are transparent to all users. 
However, during a failure, the system might: 


¢ Write a message to the console indicating there was an error reading or 
writing to the plex on the boot disk 


¢ Experience slow performance (depending on the problem encountered 
with the disk containing one of the plexes in the root or swap volumes) 


To reboot the system before you replace the original boot disk, you can boot 
from any disk that contains a valid rootvol volume. 


If all copies of rootvol are corrupted and you cannot boot the system, you 
must reinstall the operating system. 


Replacing a boot disk is a more complex process than replacing other disks 
because boot-critical data must be placed in specific areas on specific disks 
for the boot process to find it. How you replace a failed boot disk depends on: 


¢ If you have mirrored the root disk and enabled hot-sparing support. 


¢ \ftheerrors are correctable and the same disk can be reused. This is 
known as readding a disk. If you reuse the boot disk, you should monitor 
it and replace it during your next maintenance cycle. 


e If thedisk has failed completely and must be replaced. 


The section that follows gives instructions for replacing the boot disk, as well 
as other information related to boot disk recovery. 


6.5.6.1 Replacing a Failed Boot Disk 
The following procedure assumes that you originally encapsulated the boot 


disk and created mirror plexes for the boot disk volumes. The last step in 
this procedure creates a new (replacement) mirror on the new disk. 
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To replace a failed boot disk under LSM control with a new disk: 


1. Reboot the system from the nonfailed disk. 


2. Display the status of all LSM disks and volumes to ensure you use the 
name of the failed disk and failed plex in the remaining steps: 


# voldisk list 
# volprint -ht 


3. Dissociate the plexes on the failed disk from the root, swap, and user 
volumes, if /usr or /var were encapsulated on the boot disk. 


# volplex -o rm dis rootvol-02 swapvol-02 vol-dsk0g-02 


The /usr and /var volumes have names derived from the partition 
letter of the boot disk (for example, vol-dskOg). 


4. Remove the failed LSM disks for the boot disk: 


a. Remove the disks from the rootdg disk group: 
# voldg rmdisk dskna dsknb dskng ... 


b. Remove the LSM disks configured on the boot disk from LSM 
control: 


# voldisk rm dskna dsknb dskng ... 


5. Physically remove and replace the failed disk. 
6. Scan for the new disk: 
# hwmgr -scan scsi 


7. Modify the device special files, reassigning the old disk name to the new 
disk. Make sure you list the new disk first. 


# dsfmgr -e new name old name 

8. Label the new disk, setting all partitions to unused: 
# disklabel -rw new disk 

9. Mirror the existing root volumes onto the new disk: 


# volrootmir new disk 


6.6 Problems Importing a Disk Group 


If you receive an error message when trying to import a disk group or the 
command fails, possible causes are: 


¢ Oneor more of the disks contains the host |D of another system. 
To verify this, enter: 


# voldisk list da_ name 
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If the host |D of the disk does not match that of the system where you 
are trying to import the disk group, enter: 


# voldisk clearimport da_name 
You can now import the disk group. 
One or more of the disks might be inaccessible. 


Some disks might have failed. You can forcibly import the disk group 
and resolve the problem later; for example, replace the failed disk. 


To forcibly import a disk group, enter: 
# voldg -f£ import disk group 
Once the disk group is imported, you can identify and solve the problem. 


6.7 Removing the LSM Software 


This section describes how to remove LSM froma system. This process 
involves: 


Backing up user data 
Unencapsulating disks or data 
Removing LSM objects and the software subsets 


Caution 


Deconfiguring LSM causes any current data to belost. You should 
unencapsulate and back up any needed data before proceeding. 


Reconfigure any system file systems and swap space so they are no 
longer on an LSM volume. 


a. If root and swap are configured under LSM, enter the volunroot 
command and reboot the system. 


If additional swap space was configured using LSM volumes, 
remove those volumes (Section 5.4.6). 


b. Unencapsulate the /usr and /var file systems if these are 
configured under LSM. See Section 3.4.3.8 if /usr and /var are 
encapsulated under LSM. 


Unmount any other file systems that are using LSM volumes so all 
LSM volumes can be closed. 


a. Update the /etc/fstab file if necessary so that it no longer 
mounts any file systems on an LSM volume. 
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10. 


11. 


b. Stop applications that are using raw LSM volumes and reconfigure 
them so that they nolonger use LSM volumes. 

Identify the disks that are currently configured under LSM: 

# voldisk list 

Restart LSM in disabled mode: 

# vold -k -r reset -d 

This command fails if any volumes are open. 

Stop all LSM volume and I/O daemons: 


# voliod -f set 0 
# voldctl stop 


Update the disk labels for the disks under LSM. See step 3. 
e For each LSM sliced disk, repartition and update the disk labels: 
# disklabel -rw disk 


¢« For each LSM simple disk, update the partition’s fstype field to 
unused: 


# disklabel -s dsknc unused 


¢ For each LSM nopriv disk, update the partition’s fstype field to 
either unused or the appropriate value, depending on whether the 
partition still contains valid data. 


For example, if dsk2g was an LSM nopriv disk that still contains a 
valid UNIX File System and dsk2h was an LSM nopriv disk that no 
longer contains valid data, enter: 


# disklabel -s dsk2g 4.2BSD 
# disklabel -s dsk2h unused 


Remove the LSM directories: 
# rm -r /etc/vol /dev/vol /dev/rvol /etc/vol/volboot 


Delete the following LSM entries in the /etc/inittab file: 
lsmr:s:sysinit:/sbin/lsmbstartup -b </dev/console >/dev/console 2>&1 ##LSM 


lsm:23:wait:/sbin/lsmbstartup </dev/console >/dev/console 2>&1 ##LSM 
vol:23:wait:/sbin/vol-reconfig -n </dev/console >/dev/console 2>&1 ##LSM 


Display the installed LSM subsets: 

# setld -i | grep LSM 

Delete the installed LSM subsets: 

# setld -d OSFLSMBASEnnn OSFLSMBINnnn OSFLSMCLSMTOOLSnnn 


To deconfigure LSM fromthe kernel, replace the pseudo-device 1sm 
1 entry in the /sys/conf/hostname fileto pseudo-device lsm 0. 
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You can make this change either prior to running the doconfig 
command or while running the doconfig command; for example: 


# doconfig -c hostname 


Copy the new kernel to root (/) and reboot the system by entering 
the following commands: 


# cp /sys/RIO/vmunix / 
# shutdown now 


When the system reboots, LSM will no longer be installed. 
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Error Messages 


LSM is fault-tolerant and resolves most problems without system 
administrator intervention. If the volume daemon (vold) recognizes what 
actions are being taken, it can roll a transaction forward or back. If vold is 
unable to recognize and fix system problems, you need to solve the problem. 


This appendix describes the majority of informational, failure, and error 
messages displayed by vold and the kernel driver. These sections include 
some errors that are infrequently encountered and difficult to troubleshoot. 
Causes are included to elaborate on the situation or problem that might have 
generated a particular message. Wherever possible, a recovery procedure 
(solution) is provided to locate and correct potential problems. 


If you need to contact your customer support organization, these messages 
are numbered for ease of reference. 


7.1 Volume Daemon Error Messages 


The following list contains the error messages associated with the volume 
(vold) daemon. 
1. -r must be followed by ‘reset’ 
Cause: This message is caused by a usage error. 
Solution: Correct the usage and try again. 
2. -x argument : prefix too long 


Cause: The stub-mode device path prefix name supplied exceeded the 
maximum of 32 characters. 


Solution: Select an alternate path for device files and retry the 
command. 


3. -x string : invalid debug string 
Cause: An unknown argument string was given to the -x option to vold. 


Solution: Select a valid string from the reference page for vold and try 
again. 


4. Usage: vold [-dkf] [-r reset] [-m mode] [-x level] 
For detailed help use: vold help 


Cause: vold was invoked with an invalid set of arguments. 
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Solution: Correct the usage and try again or type vold help for more 
help. This is the full usage message from entering vold help: 


Usage: vold [-dkf] [-r reset] [-m mode] [-x level] 
Recognized options: 
-d set initial mode to disabled for transactions 
-k kill the existing configuration daemon process 
=f operate in foreground; default is background 


-r reset reset kernel state; requires ‘reset’ option argument 
-m mode set vold’s operating mode 
modes: disable, enable, bootload, bootstart 
-x level set debugging level to <debug>, 0 turns off debugging 
-R file set filename for client request rendezvous 
-D file set filename for client diag request rendezvous 
5. 1sm:vold: Error: volume volume : Logging daemon 


killed by \ signal signal_number [ core dumped ] 
Cause Someone killed the logging daemon. 
Solution: If required, restart the daemon by entering voliod logio. 


6. lsm:vold: Error: /dev/volevent: error_message 
lsm:vold: Error: cannot open 
/dev/volconfig: error_message 
lsm:vold: Error: Cannot kill existing 
daemon, pid= process _id 


Cause An attempt to kill an existing vold process with a SIGKILL 
signal has failed. This might be dueto the process being in an unkillable 
kernel state perhaps because of a hung!/O or a missing I/O interrupt. 
There might be disk driver error messages in the /dev/osm buffer. 


Solution: Try typing cat /dev/osm to see if any other messages have 
been output to the console device. If possible, use crash to determine 
the state of the process. If the process is asleep waiting for an |/O 
completion, then any disk driver error messages that have occurred 
might point to the solution. Failing this, a reboot is recommended. 


7. Ism:vold: Error: /dev/voliod: VOL LOGIOD CHECK 
failed 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then attempt to 
reboot the system, possibly followed by reinstalling the LSM software. 
If this fails, contact Customer Support. 


8. lsm:vold: Error: /dev/voliod: VOL_LOGIOD_ KILL failed 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 
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Solution: Try stopping and restarting vold. If this fails then attempt 
to reboot system, possibly followed by reconfiguring LSM. If this fails, 
contact Customer Support. 


lsm:vold: Error: All transactions are disabled 


Cause: This message might appear with the message Disk group 
disabled by errors if the disk group to be disabled is the root disk 
group. The continued use of the system could be dangerous because 
any configuration changes required (including error handling cases) 
could cause the loss of ability to perform I/O toa volume. Because this 
includes the root volume, this situation could, if uncorrected, cause 
the system to hang. 


Solution: This isa fatal error. All copies of the bootable root disk have 
failed. Recovery from this situation will require booting from floppy 

or from a disk unconnected with the LSM software. It might then be 
necessary to remove the LSM rootable disk configuration by using the 
volunroot command. See theLSM installation instructions for details. 
Once this has been achieved, the root disk group can be reinitialized to 
reestablish the database and log areas. 


lsm:vold: Error: Cannot get all disk groups from the 
kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot 
the system, possibly followed by reinstalling the LSM package. If this 
fails, contact Customer Support. 


lsm:vold: Error: Cannot get all disks from the kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be duetoa bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 


lsm:vold: Error: Cannot get kernel transaction state 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting the vold daemon. If this fails 
then reboot the system, possibly followed by reconfiguring LSM. If this 
fails, contact Customer Support. 
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13. lsm:vold: Error: Cannot get private storage from 
kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution:Try stopping and restarting vold. If this fails then reboot of 
the system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 


14. lsm:vold: Error: Cannot get private storage size from 
kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 


15. lsm:vold: Error: Cannot get record name from the 
kernel: error_message 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 


16. lsm:vold: Error: Cannot not make directory 
directory path 


Cause: When trying to create the specified directory, vold got a failure. 


Solution: Try creating the directory manually and then issue the 
command voldctl enable. 


17. lsm:vold: Error: Cannot recover operation in progress 
Failed to get group disk_group from the kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 


18. lsm:vold: Error: Cannot start usage type volume, no 
valid complete plexes 
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Cause: No usable plexes remain for either the root or swap volume. This 
error is fatal and will result in the message System startup failed 
also appearing and the system being shutdown. 


Solution: This is generally an unrecoverable error and will likely 
require that you reload the system from backups. 


lsm:vold: Error: Cannot start usage _type volume, no 
valid plexes 


Cause No usable plexes remain for either the root or swap volume. This 
error is fatal and will result in the message System startup failed 
also appearing and the system being shutdown. 


Solution: This is generally an unrecoverable error and will likely 
require a reload of the system from backups. 


lsm:vold: Error: Cannot start usage type volume, 
volume state is invalid 


Cause: The volume is not in a state that can be recovered from. This 
might be because of corruption of the databases or because of an invalid 
use of the vold interfaces without the use of the utilities. 


Solution: This is generally an unrecoverable error and will require 
reloading of the system from backups. 


lsm:vold: Error: Cannot store private storage into 
the kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 


lsm:vold: Error: Differing version of vold installed 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 


Ilsm:vold: Error: Disk disk, group disk_group, device 


device name : \ not updated with new host ID \ Error: 
error message 


Cause If the host |D for a system is changed usingthevoldctl init 
command then all disks in all imported disk groups will need to have 
the host 1D changed to the new ID. If the host ID for a disk cannot be 
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changed, then this message will be displayed. Other problems might 
also exist for this disk. 


Solution: Move the contents of the disk elsewhere and reinitialize the 


disk. 
24. lsm:vold: Error: Disk group disk group, Disk disk : 
Cannot auto-import group: error_message 


Cause: The disk group disk_group, could not be reimported after a 
system restart. The reason is given as part of the error message. Other 
error messages might appear which provide more information on what 
went wrong. Any volumes in the disk group will be unavailable until 
you fix the error condition and reimport the disk group. 


Solution: Clear the error condition, if possible, and then import the 
disk group manually with voldg import. After importing, restart all 
volumes with voldg -g groupname -sb. 


25. lsm:vold: Error: Disk group disk group, Disk disk : 
Group name collides with record in rootdg 


Cause: The disk group name disk group, for the disk group being 
imported from the named disk, collides with a configuration record in 
the rootdg disk group. Disk groups must have names that do not match 
any records in the root disk group. 


Solution: If you want to import the disk group, rename the conflicting 
record in rootdg to some other name. 


26. lsm:vold: Error: Disk group disk group : Cannot 
recover temp database error message 


Cause: The temp database stored in the root file system could not be 
opened or read. Other messages will detail the error. This might happen 
because of an I/O error or a problem in the file system. 


Solution: Reboot the system and retry the operation. 


27. lsm:vold: Error: Disk group disk group : Disabled 
by errors 


Cause: This message can appear if the last configuration database or 
last kernel log area for a disk group became disabled. This could have 
been due to an I/O error or some other condition. Other messages 
preceding this one are likely to highlight the root cause. 
Solution: Back up any remaining active volumes. Reinitialize the disk 
group and add the disks back to the group to recover. 

28. lsm:vold: Error: Disk group disk group : Errors in 
some configuration copies: 


Cause: One or more on-disk database copies were found to contain 
errors. As aresult, the disk group could not be imported. This is 
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probably due to a disk I/O error, or to blocks of a configuration copy 
being overwritten within invalid contents. Check for messages from the 
disk driver. Errors pertaining to specific configuration copies are listed 
on successive lines. These lines can bein either of the following forms: 
File filename : error_message : \ 

Block number : error_message 


Disk diskname, copy copy number : \ 
error_message : Block number : error_message 


Lines beginning with File indicate an error in the special configuration 
copy file used for storing nonpersistent disk group information. Lines 
beginning with Disk indicate failure of a persistent configuration 

copy stored on a disk. The copy number indicates which of the disk’s 
configuration copies contains the error. 


Solution: If one or more disks for the disk group are currently 
inaccessible (such as due to a cabling error), make the disks accessible 
and try to import the disk group again with voldg import. Otherwise, 
the disk group is probably no longer usable and you will have to recreate 
it. All volume configuration information for the disk group is lost. 


lsm:vold: Error: Disk group disk_group : Reimport of 
disk group failed: error_message 


Cause: The reload of a disk group into the kernel failed. This could be 
because the log size for the kernel might not be set or because of some 
other error in the import procedure. Other messages should indicate the 
true cause of the failure. 


Solution: Retry the operation unless some other error message leads to 
a suggested course of action. If this fails, reboot the system. 


lsm:vold: Error: Disk group disk_group : update 
failed: error_message 

Cause: This message occurs because a database update failed 
completely. No complete copy of the database could be written for the 
disk group. The disk group will be disabled and further access for 
configuration changes will be disallowed. If this error occurs for the root 
disk group, it will probably be necessary to reinstall the system. 
Solution: Back up any volumes still activein the disk group. Reinitialize 
the disk group and add the disks back to it. 


lsm:vold: Error: Exec of /sbin/voliod failed 
Cause: An exec of /sbin/voliod failed. 


Solution: Check the existence and permissions of the /sbin/voliod 
command. Try executing the command manually to ensure that it can 
be run. 


lsm:vold: Error: Failed to store commit status list 
into kernel:error_ message 
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Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be due toa bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring of LSM. If this fails, contact 
Customer Support. 


33. lsm:vold: Error: Fork of logio daemon failed 


Cause: The creation of a process that could then be used as a logging 
daemon failed. 


Solution: Check for messages explaining the reason that a fork(2) call 
failed. Retry the operation. 


34. lsm:vold: Error: GET _VOLINFO 
ioctl failed: error_message 
lsm:vold: Error: Version number of kernel does 
not match vold 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring of LSM. If this fails, contact 
Customer Support. 


35. lsm:vold: Error: Get of current rootdg failed 


Cause An attempt to retrieve the rootdg from the kernel failed. This 
might be because of a kernel vold inconsistency or could also be because 
of a version difference between vold and the kernel. 


Solution: Check that the correct version of vold and the kernel are 
installed. Other messages might suggest other problems in a prior 
attempt at loading a configuration and possible courses of action. If this 
fails, contact Customer Support. 


36. lsm:vold: Error: No convergence between root disk 
group and disk list Disks in one version of rootdg: 
disk type= disk_type info= disk_info Disks in alternate 
version of rootdg: disk type= disk_type info= 
disk_info 


Cause: This message can appear when vold is not running in 
autoconfigure mode (see the vold(8) reference page) and when, after 
several retries, it cannot resolve the set of disks belonging to the root 
disk group. The algorithm for disks that are not autoconfigured is to 
scan disks listed in the /etc/vol/volboot file and then examine 

the disks to find a database copy for the rootdg disk group. The 
database copy is then read to find the list of disk access records for disks 
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contained in the group. These disks are then examined to ensure that 
they contain the same database copy. As such, this algorithm expects to 
gain convergence on the set of disks and the database copies contained 
on them. If a loop is entered and convergence cannot be reached, then 
this message will appear and the root disk group importation will fail. 


Solution: Reorganizing the physical locations of the devices attached 
to the system might break the deadlock. If this fails, contact Customer 
Support. 


lsm:vold: Error: Open of directory directory _path 
failed 


Cause: When vold was trying to create node files for the volumes, it 
was unable to open the directory in which the nodes were to be created. 


Solution: Check for other errors that suggest why the directory might 
be missing or if the permissions might be incorrect. Fix the condition 
to allow vold to open or create the directory, then issue the command 
voldctl enable. 


lsm:vold: Error: Read of directory directory path 
failed 


Cause: The node directory could not be read when vold was trying 
to scan for volume nodes. 


Solution: Check for other messages that might suggest why the 
directory is inaccessible. Try reading the directory manually if the 
directory is corrupted, then try removing and recreating it and then 
restarting vold. 


lsm:vold: Error: Unexpected configuration tid for 
group disk group found in kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioct1 to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring of LSM. If this fails, contact 
Customer Support. 


Ilsm:vold: Error: Unexpected error during usage _type 
volume reconfiguration: error_message 


Cause A record lock for the volume could not be acquired as part of the 
initial volume setup for either a root or swap volume. This is most likely 
to occur under low memory conditions. 


Solution: Other messages might suggest an alternate course of action. 
Otherwise, this is generally an unrecoverable error and will require 
that you either boot off an alternate root device or reload the system 
from backups. 
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41. lsm:vold: Error: Unexpected error fetching disk for 
usage_type volume: error_message 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring of LSM. If this fails, contact 
Customer Support. 


42. lsm:vold: Error: Unexpected values stored in the 
kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring of LSM. If this fails, contact 
Customer Support. 


43. lsm:vold: Error: VOL _RESET_KERNEL failed: a volume 
or plex device is open 


Or: 


lsm:vold: Error: VOL RESET KERNEL failed: 
error_message 


Cause: An attempt at resetting the kernel state with avold -r reset 
command failed because all the LSM objects in the kernel were not 
closed. If any volumes arein use, then the reset cannot be performed. 
This might also happen if a reset was requested on a system with root 
volumes. Root volumes are, by definition, never closed and so a reset 
cannot be performed. 


Solution: If you really want to reset the kernel, then check the state 
of the volumes and any mounted file systems to display information 
about who might have them open. Unmount all volumes and kill any 
processes accessing the volumes, then reset the kernel. 


44. lsm:vold: Error: mode : Unrecognized operating mode 
Cause An unknown mode string was entered following a -m option. 


Solution: Select a valid mode from the vo1d(8) reference page and try 
again. 

45. lsm:vold: Error: cannot open /dev/voliod: 
error _ message 


Cause: The open of the /dev/voliod file can fail only if the device node 
is missing or has an incorrect major or minor number. 
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Solution: Check the existence and values of the file and make sure that 
the LSM software was correctly installed. 


lsm:vold: Error: cannot open argument : error_mes- 
sage 


Cause: The tracefile specified on the command line could not be opened 
in append mode. The error message supplied should explain the reason. 


Solution: Select an alternate tracefile name that can be created or 
appended to. 


lsm:vold: Error: cannot open volconfig device : 
Device is already open 


Or: 


lsm:vold: Error: cannot open volconfig device : 
error_message 


Cause The exclusive open device (/dev/volconfig) is already open. 
Only one vold process can be active on the system at one time. 
Subsequent attempts at starting vold or opening the device will result 
in this message. 


Solution: Check for other running vold processes. Thevoldct1l mode 
command will report if vold is currently active. 


lsm:vold: Error: enable failed: error_message 


Cause: This message might occur during an initial startup of vold. If 
changing to enabled mode when this error occurs, failures could be 
due to problems with the creation of the portal or with connection to 
the kernel. If changing from an enabled state to a disabled state, then 
problems could occur with removing the disk groups from the kernel 
because of such things as volumes in use. 


Solution: Evaluate other error messages occurring with this one to 
determine the root cause of the problem. Make changes suggested by 
the other errors and then retry the command. 


lsm:vold: Error: failed to create daemon: fork 
failed: error_message 


Cause: The call to fork(2) to generate a background vold process failed. 


Solution: Check for messages explaining the reason that a fork(2) call 
failed. Retry the operation. 


lsm:vold: Error: volume volume : Wait for logging 
daemon failed 


Cause: The wait called to wait for the existence of the daemon process 
did not execute correctly. This can happen only if the ioct1 does not 
correctly match the command required, perhaps because of a mismatch 
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between the voliod command and the kernel versions or perhaps 
because of an incorrect minor number for the /dev/voliod device. 


Solution: Check the existence and permissions of the /dev/voliod 
device. 


51. lsm:vold: FATAL Error: Disk group rootdg: 
Inconsistency -- Not loaded into kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring of LSM. If this fails, contact 
Customer Support. 


52. lsm:vold: FATAL Error: Group disk group : Cannot 
update kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be duetoa bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring of LSM. If this fails, contact 
Customer Support. 


53. lsm:vold: FATAL Error: Interprocess communication 
failure: error_message 


Cause: The portal to client utilities has returned a failure. Thisisa 
fatal error because without a portal to clients, vold cannot do anything 
useful. 


Solution: Check for other errors suggesting the reason for portal failure. 
Restart vold. If problems persist, reboot the system. 


54. lsm:vold: FATAL Error: Invalid status stored in 
kernel 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring of LSM. If this fails, contact 
Customer Support. 


55. lsm:vold: Warning: Cannot create device path : 
error message 


Cause: The mknod(2) call made by vold to create a device node failed. 
The reason for the error should be displayed. 
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Solution: Fix the reason indicated for node creation failure and then 
issue the command voldctl enable. 


lsm:vold: Warning: Cannot exec /sbin/rm to remove 
directory path : error_message 


Cause: An exec of /sbin/rm failed. 


Solution: Ignore the error. It is not serious if the directory could not 
be removed. 


lsm:vold: Warning: Cannot fork to remove directory 
directory path : error _message 


Cause: The call to fork(1) to generate a process that could then exec 
xrm(2) failed. 


Solution: Ignore the error. It is not serious if the directory could not 
be removed. 


lsm:vold: Warning: Disk device_name in kernel not a 
recognized type 


Cause: The disk type of a disk in the kernel does not match any 
known disk type. This can occur only if vold and the kernel arein an 
inconsistent state. 


Solution: Try stopping and restarting vold. If this fails then reconfigure 
LSM. If this fails, contact Customer Support. 


Ilsm:vold: Warning: Disk disk names group disk group, 
but group ID differs 


Cause: As part of a disk group import, a disk was discovered that had a 
mismatched disk group name and disk group |D. This disk will not have 
been imported. This can happen only if two disk groups of the same 
name exist that have different disk group 1D values. In that case, one 
group will beimported along with all its disks and the other group will 
not. This message will appear for disks in the unselected group. 


Solution: If it turns out that the disk should be imported into the group, 
then you will have to add the disk to the group at a later stage. It 

will not happen automatically as part of the import. All configuration 
information for the disk will also be lost. 


Ism:vold: Warning: Disk group disk _group is disabled, 
disks not updated with new host ID 

Cause If the host ID for a system is changed usingthevoldctl init 
command then all disks in all imported disk groups will need to have 
the host |D changed to the new ID. If a disk group is found in the 
imported but disabled state, then the host ID will not be changed. 


Solution: Clear the host ID usingthe voldisk clearimport command 
for each disk, and then reimport the disk group. 
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61. lsm:vold: Warning: Disk group disk group : 
Disk group log may be too small 
Log size should be at least number blocks 


Cause: The log areas for the disk group have become too small for the 
size of configuration currently in the group. This should usually never 
happen without first displaying a message about the database area size. 
This message occurs only during diSk group import; it occurs if the 
disk was inaccessible while new database objects were added to the 
configuration, and the disk was then made accessible and the system 
restarted. 


Solution: If this situation does occur, then reinitialize the disks in the 
group with larger log areas. See the voldisk(8) reference page for more 
information. To reinitialize all the disks, detach them from the group 
with which they are associated, and then reinitialize and readd them to 
the disk group. Deport and reimport the group for the changes to the log 
areas for the group to take effect. 


62. lsm:vold: Warning: Disk group disk group : Errors in 
some configuration copies: 


Cause: One or more on-disk database copies were found to contain 
errors. As aresult, the disk group could not be imported. This is most 
likely to be due toa disk I/O error, or to blocks of a configuration copy 
being overwritten within invalid contents. Check for messages from 
the disk driver. Providing that other copies of the database can be 
successfully read, the system will continue and the disk group import 
or initial vold enable operation should succeed. If the database copy 
can subsequently be written to, then this message will not recur. Errors 
pertaining to specific configuration copies are listed on successive lines. 
These lines can bein either of the following forms: 

File filename : error_message : Block number : error_message 


Disk diskname, copy copy number : error_message : \ 
Block number : error_message 


Lines beginning with File indicate an error in the special configuration 
copy file used for storing nonpersistent disk group information. Lines 
beginning with Disk indicate failure of a persistent configuration 

copy stored on a disk. The copy number indicates which of the disk’s 
configuration copies contains the error. 


Solution: This message is likely to occur once due to an I/O failure and 
then not reoccur. If it does reoccur, then it might be necessary to remove 
the disk and reinitialize it to dear the condition. If all configuration 
copies for a disk group become unusable, then the disk group itself 
becomes unusable and must be recreated. If the rootdg disk group 
becomes unusable, you might need to reconfigure LSM. In this case, if 
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63. 


64. 


65. 


66. 


67. 


root file system is on a volume, then you might need to reinstall the 
operating system itself. 


lsm:vold: Warning: Error in volboot file: 
error_message 


Entry: disk disk disk_type disk_info 


Cause: This message occurs when an entry in the volboot file does not 
contain the correct information to define a valid disk access record. 


Solution: Remove the entry using the voldct1 rmdisk command and 
add it again using voldct1 adddisk. 


lsm:vold: Warning: Failed to update voldinfo area in 
kernel: error_message 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 


lsm:vold: Warning: Field too long in volboot file: 
Entry: disk disk disk_type disk_info 

Cause The volbcot file is maintained by vold and voldct1 and 
should never normally exhibit this problem. This problem might 
indicate some corruption of the volboot file or could also be the result 
of manual editing of the file. 


Solution: The offending entry could try to be removed by use of the 
voldctl rmdisk command. If this fails, volboot might have to be 
reinitialized using avoldct1l init command. 


lsm:vold: Warning: Get of record record_name from 
kernel failed: error_message 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 

Ilsm:vold: Warning: Plex plex for usage_type volume 

is stale or unusable 

Cause: This message is output to alert the user to the failure of one 

or more plexes of either the root or swap volume. The system might 

be able to continue depending on the existence of other usable plexes 
for the volume. 
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68. 


69. 


Solution: Repair the failed plex by either reattaching the plex to the 
volume once the system is booted, or by evacuating and replacing the 
disk on which the failed plex resides if you think that the disk is going 
bad. 


lsm:vold: Warning: cannot remove group group_id from 
kernel: error_message 


Cause: Some inconsistency between vold and the kernel has caused an 
ioctl to fail. This could be caused by the use of older versions of vold 
or the kernel, or it could be dueto a bugin LSM. 


Solution: Try stopping and restarting vold. If this fails then reboot the 
system, possibly followed by reconfiguring LSM. If this fails, contact 
Customer Support. 


lsm:vold: Warning: response to client client number 
failed: error_message 


Cause: The portal to client utilities has returned a failure. Thisisa 
fatal error because without a portal to clients, vold cannot do anything 
useful. This could be caused by a STREAMS error or some other 
communications problem with the client. 


Solution: Check for other errors suggesting the reason for portal failure. 
Restart vold. If problems persist, reboot the system. 


7.2 Kernel Error Messages 


The following are the kernel level error messages. 


L: 


NOTICE: message on volume device hex device number ( 
volume ) in diskgroup disk_group 


Cause This is caused by a driver above the LSM level calling the LSM 
volprint function. This usually happens when a driver detects some 
error condition in LSM and want to display the error. 


Solution: No action necessary, unless specified in a supplied string. 


NOTICE: io/vol.c(volerror): Correctable type error on 
volume volume, e plex plex, block block_number 


Cause: A correctable 1/O error was detected and corrected. A correctable 
1/O error is one where a read error from an underlying device driver 
could be corrected by reading the data from an alternate mirror copy 
and then writing it back to the failed mirror. 


Solution: If the 1/O could have been completed by reading from an 
alternate mirror but the writeback to the failed mirror still failed, the 
mirror will be detached. This failure will cause the exception handling 
code to recover the volume according to its error recovery policy. This 
usually results in either a mirror or the volume becoming detached. 
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You must reattach the mirror (volplex att), to bring back the failed 
mirror copy. If the volume was detached, then the data contained on it 
is unrecoverable and will have to be restored from backups. 


NOTICE: io/vol.c(volerror): Uncorrectable type error 
on volume volume, \ plex plex, block block _number 


Cause: Following an I/O error from one mirror, an attempt to reread 
the data from an alternate mirror failed. This could be because no other 
mirrors exist or could be because the other mirrors also had I/O failures. 


Solution: This failure will cause the exception handling code to be 
entered, which will result in the volume’s error recovery policy being 
followed. This can have effects ranging from detaching a mirror to 
disabling the volume. You must reattach the mirror (volplex att), 
to bring back the failed mirror copy. If the volume was detached, then 
the data contained on it is unrecoverable and you will have to restore it 
from backups. 


NOTICE: lsm: Can’t open device disk, device busy or 
inaccessible. 


Cause: The named disk cannot be accessed. 
Solution: Turn on the drive. 


WARNING: io/vol.c(volexcept): No volume error daemon - 
Cannot Log plex detach, \ detaching volume 


Cause: No voliod process was running and able tolog a detach record 
for a mirror that is being detached due to an I/O error. This is a fatal 
error that causes future access to the volume to be rejected, because any 
system failure coming after additional |/O would not be able to detect 
the failure of the mirror and mirror inconsistencies might then occur. 


Solution: Although it is too late to rescue this volume, you should start 
at least one voliod process as soon as possible (using voliod set 2). 
Stop and restart the failed volume, then restore the data from backups. 
Mirrors will have become inconsistent and so any attempt at using the 
data on the volume could prove disastrous. 


WARNING: volklog_ dgfree: Can’t clear group commit log 
record for group disk_group 


Cause: This can occur if a log flush to disk could not be performed 
because no valid log copies remained. This is likely to compromise the 
ability of the LSM to recover from any further I/O errors. 


Solution: When you add disks to the system, ensure that new viable 
logging areas can be generated. Alternatively, remove failed disks and 
replace them with working devices. 
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7. WARNING: volklog dgfree: Can’t free kernel logging 
area for vol_reset_kernel of group disk_group 


Cause: A free of the logs for a disk group failed because either no valid 
log areas remained for flushing or some log records remained in the log 
before the clear operation was requested. 


Solution: There is no action to take here; this is an LSM internal error. 
Contact Customer Support. 
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A 


The Storage Administrator 


This chapter describes how to manage LSM objects, including disks, disk 
groups, volumes, plexes, and subdisks using the Storage Administrator GUI. 
The tasks described in this chapter can also be accomplished by using: 


¢ Thecommand line. 


e Thevoldiskadm menu interface. See Appendix C for more information 
on the voldiskadm menu interface. 


¢ The Visual Administrator. See Appendix D for more information on 
the Visual Administrator. 


See Appendix B for more information on how to track Storage Administrator 
activities, and how to customize the Storage Administrator GUI. 


A.1 Overview 


The Storage Administrator is a] ava-based graphical user interface (GUI) 
for LSM. The Storage Administrator displays a hierarchical view of LSM 
objects and their relationships. You use the Storage Administrator to view 
and manage LSM objects on a local or remote (client) system. 


The Storage Administrator provides dialog boxes in which you enter 
information to create or manage LSM objects. Completing a dialog box might 
be the equivalent of entering several commands. 


The Storage Administrator consists of a server (daemon) and a client. The 
Storage Administrator server runs on a system on which the LSM software 
is initialized and running. The Storage Administrator client runs on any 
machine that supports the} ava run-time environment. 


Note the following considerations when using the Storage Administrator: 


e If you are working in a TruCluster environment, some restrictions apply. 
Dialog box options for invalid tasks are grayed out. 


e Mirrors are allowed in clusters unless the disk to be mirrored isa 
clusterwide root, an individual member boot partition, a quorum disk, or 
swap disk. 


¢ Software-based RAID 5 technology is not supported in clusters. If you 
want RAID 5 functionality, you must use hardware RAID devices. 
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e AdvFS file systems are supported in all modes. 
¢ UFS file systems are supported in read-only mode. 


A.1.1 Installing and Starting the Storage Administrator 


To install the Storage Administrator, choose the LSM GUI option during the 
LSM installation. Install the Storage Administrator on all systems on which 
you want to use the Storage Administrator to remotely manage the LSM 
software. See Chapter 3 for information on initializing the LSM software. 


To use the Storage Administrator, you must login as root unless your user 
name is in the /etc/group file for the system, in the group defined for the 
Storage Administrator administration (lsmsa_admin by default). 


To start Storage Administrator, enter: 
# /usr/bin/lsmsa 


The Session Initiation dialog box is displayed in which you enter the 
following information, then click on Ok: 


« Thename of the system to be administered in the Host Server field 
* root or your user name 
e« The password associated with the account 


e« When the GUI is started, the system attempts to connect it with the 
server process on the indicated host. 


e |f the GUI cannot connect, the system then attempts to connect it tothe 
indicated host at the port, init1lsmsad, defined in the /etc/services 
file, and vrts.remote.server.initLsmsadPort, defined in the 
/usr/lib/java/applications/1smsa/properties file. The port 
number defined in these two files must be the same. 


When the GUI connects to the initlsmsad port, the inetd server 
executes the /usr/lib/java/applications/initlsmsad program, 
which creates a subprocess where the /usr/sbin/1smsad script 

will run. The 1smsad script starts the LSMSA server processes 
vMServerImp1, VRTSRegistry and cmdserver. Once the LSMSA 
server processes are started, the GUI then connects and operates 
normally. 


¢ Ifthe GUI cannot connect toa port, the error message “Cannot connect 
to the server” is shown. When LSMSA exits and disconnects from the 
server, the server continues to exist in an idle state until another GU] 
connects or an LSM configuration event occurs (such as creation, deletion 
or modification of a LSM object). When the server receives notification of 
a LSM configuration event, if no GUIs are connected, the server exits. 
When the server exits, all of the LSMSA server processes exit, as well. 
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If the GUI cannot connect to the server, try the following: 


« Check the /var/lsmsa/logs/server.1log file for startup and error 
messages. 


Run the /usr/lib/java/applications/initlsmsad program to 
view error messages. You must be root user. 


¢ Ona very slow network, you might need to adjust the value assigned to 
the CONNECTION_TIMEOUT variablein the /usr/sbin/1lsmsadscript. 
This is the amount of time after startup that the LSMSA server will wait 
for a connection from the client. The default value is 30 seconds. When 
the server process receives a LSM configuration event, if no GUIs have 
been or are currently connected the CONNECTION_TIMEOUT seconds have 
elapsed, the server exits. 


A.1.2 Storage Administrator Main Window 


The Storage Administrator main window consists of two panes. The left 
pane displays a hierarchical tree of objects. The right pane displays an object 
table that lists the properties of the object selected on the left. The window 
also has a menu bar and a command launcher that you can hide or display to 
initiate LSM options. Figure A-1 shows the components of the main window. 


Figure A-1: The Storage Administrator Main Window 


Menu 
Bar = 
Storage Administrator @servername.com | 
Tool ConSole Options Window Selected Help | 
Bar \@ [2/8] // | S82) 3/3 
ISA | Task | Alert |Search) Table New | Props| Prefs) Save 
: [BX storage Administrator Storage Administrator/Disks! Obiect 
Object & Disk Groups Fil Tevice || Disk Name | Disk Group | Size | Unu: J 
Tree | Disks (@& disconnected) root rootdg 2514 M Table 
@ Volumes & disconnected] dskOd-4.2BSI rootdg 15G 
S's Controllers @ disconnected dskOe rootdg i 
$3 Free Disk Pool ||s&e dskoa 2 a 0 
#6 Uninitialized Disks Splitters 
File Systems | 28 dskod z = 0 
f 
Object Command |Description 
@ Disk Add 
& Disk y Mirror mes on a disk, 


Cc d & Disk Offline Take disk(s) offline 
omman [2] Disk Online Bring disk(s) online. 


Launcher Disk Recover Recover all volume(s) that use the selected disks. 
isk Remove Remove a disk from a disk group or the Logical Storage Manager 


IG Disk Rename Change the name of a disk. 
& Disk Replace Replace a disk with a new disk. 
GP Disk Scan Check for new disks. 

Help & Disk Group Disable access to a disk group 


Bar = astray ss“ Destrov a disk aroun. Return its disk space to the free disk pool. = 
\ J 
I 
al | 


The Storage Administrator A-3 


The Object Tree displays the hierarchical relationship between LSM objects. 
Each object represents a group of components of the same type. When you 
select the icon to the left of an object, components of that type appear in the 
right pane. You can expand objects (by clicking on the plus sign) to display 
their hierarchy. 


The Object Table displays component objects that belong to the currently 
selected object in the Object Tree. The Object Table is dynamic and 
constantly updates its contents to reflect changes to the system. 


The Command Launcher displays a list of tasks that you can perform on 
objects. When you click on a task in the Command Launcher list, the task 
starts and the dialog box for the task appears. 


The menu bar contains the following menus: 


¢« Console menu—Provides access to the New menu, which creates 
volumes, disk groups, or file systems. It also closes the Main window, 
provides access to an object Properties dialog box, or exits the Storage 
Administrator. 


¢« Options menu—Provides access to the Preferences dialog box and saves 
or loads user preferences for Storage Administrator components. The 
Options menu also removes alert icons from the status area. 


¢« Window menu—Opens additional Storage Administrator Main windows, 
the Task Request Monitor, the Alert Monitor window, the Search window, 
a copy of the Object Table, or the Command Launcher. 


¢« Selected menu—By default, the Selected menu is grayed out and changes 
its options based on the type of object that you select. Until you have 
selected an object, you see the grayed Selected entry on the menu bar. 
When you select an object, for example Volumes, the Selected entry 
changes to Volumes. 


¢« Help menu—Provides access to online Storage Administrator help. 


The toolbar consists of the following buttons that provide access to the 
following windows: 


e¢ LSMSA button—Launches an additional Storage Administrator Main 
window 


e Task button—Launches the Task Request Monitor window 
e Alert button—Launches the Alert Monitor window 
¢« Search button—Launches the Object Search window 


¢ Table button—Launches a window that contains a copy of the main 
Object Table 
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¢ New button—Launches the New Volume dialog box that is used to create 
a volume 


¢ Props button—Launches the Object Properties dialog box for a selected 
object 
¢ Prefs button—Launches the Preferences dialog box 


¢« Save button—Saves the current preference settings for use in future 
the Storage Administrator sessions 


A.2 Performing Tasks with the Storage Administrator 
You perform most tasks by selecting objects or tasks, then providing 
information in resulting dialog boxes. You perform tasks using: 
¢ The menu bar 
¢ A pop-up menu 
¢ The Command Launcher 


A.2.1 Selecting Objects 
To select a single object, click on it. To deselect the object, click on it again. 


To select or deselect multiple objects, hold down the Control key while 
selecting the objects. The objects that you select do not have to be adjacent. 


To select a range of adjacent objects, select the first object and then hold 
down the Shift key while selecting the last object in the range. You can also 
select multiple adjacent objects by dragging the mouse over the desired 
objects while pressing the Shift key. 


A.2.2 Using the Menu Bar 


You can launch tasks from the Console and Selected menus in the menu 
bar. Choose New from the Console menu to create new LSM volumes, disk 
groups, and file systems. The context-sensitive Selected menu changes to 
reflect which object you selected in the Object Table. 


For example, to change a volume name, select Volumes in the Object Tree 
and the volume you want to rename in the Object Table. From the Volumes 
menu, choose Rename, enter information in the Rename Volume dialog box, 
and click on OK. 


A.2.3_ Using the Right Mouse Button to Display a Pop-Up Menu 


Click on the right mouse button to access a context-sensitive pop-up menu to 
display common task information that you can apply to the selected object. 
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Additional tasks are available through the menu bar or the Command 
Launcher. 


For example, to create a new volumein a disk group, select Disk Groups in 
the Object Tree, right-click on the disk group in the Object Table, choose 
New Volume from the pop-up menu, enter information in the New Volume 
dialog box, and click on OK. 


A.2.4 Using the Command Launcher 


The Command Launcher window contains a list of objects and associated 
tasks. To display the Command Launcher, choose Command Launcher from 
the Window menu. To hide the Command Launcher, choose Command 
Launcher again from the Window menu. 


To perform a task on a specific type of object, select the appropriate 
object-command combination from the Command Launcher list. For 
example, to create a volume, choose Volume-N ew from the Command 
Launcher, enter information in the New Volume dialog box, and click on OK. 


Caution 


The Command Launcher does not restrict context. If you choose 
inappropriate commands and ignore the warning dialogs, you can 
perform operations that might result in permanent loss of data. 


A.2.5 Exiting the Storage Administrator 


To exit the Storage Administrator, choose Exit from the Console menu. If 
you choose Close and there is no other Storage Administrator Main window 
open, the system exits. 


A.3 Managing Disks 


The following sections describe disk management tasks that you can 
complete using the Storage Administrator. 


A.3.1 Adding a Disk 


When you add a disk for use with the LSM software, the disk is either 
initialized or encapsulated. If the disk is not set up, initialize it. If you want 
to use a disk with partitions that arein use, encapsulate it. Encapsulation 
preserves any existing data on the disk in the form of volumes. Initialization 
destroys any existing data on the disk. I nitialized disks are placed in the 
free disk pool and are available to add to disk group. 
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To add a disk for use with the LSM software: 


1. Inthe Object Tree, select Disk and in the Object Table, choose a disk to 
place under LSM control. 


If the disk is new and does not show up in the Object Table when you 
highlight Disks, click on the Storage Administrator (at the top of the 
Object Tree) and choose Scan Disks from the Disk menu. 


In the Scan Disks dialog box, click on the Ok button to begin the search. 
From the Object Tree displayed, select a disk to add. 


2. Fromthe Disk menu, choose Add. 
The Add Disk(s) dialog box is displayed: 


- Add Disk(s) @ servername.com 


@ Free Disk Pool 


Scan Disks 
Disk Device(s): ‘dsk0a Browse... 
Add Disk(s) to: 
Existing Disk Group —Select/Create Disk Group 
New Disk Group Disk Group Hamec | Geawse... 


‘Options: 


Disk Name(s}: | 


Cement: | 


Ok Apply Cancel Help 


3. Inthe Add Disk(s) dialog box: 


a. 


If the correct disk device nameis not displayed, type the disk device 
name or click on Browse to select the disk. You can type more than 
one name separated by spaces. 

Specify where to add disks: 

To add disks toan existing disk group, select Existing Disk Group. 
Type the disk group namein the Disk Group Name field or click on 
Browse to select a diSk group. 

To add disks to a new disk group, select New Disk Group. Type 
the name of the new disk group in the Disk Group Name field. 
The new disk group is created. 

To place disks in the free disk pool, select Free Disk Pool. Disks 

in the free disk pool are under LSM control (initialized) but do not 
belong to a disk group and cannot be used to create volumes. 
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c. In the Options section: 


Specify the LSM disk names for the disks by typing a disk namein 
the Disk Name(s) field. This name must be unique within the disk 

group. If noLSM disk name is specified, the Storage Administrator 
assigns a default name to the disk. 


Enter a comment if desired. 
d. Click on Ok. 
You can add one or more unused disks toa disk group and designate them as 
hot-spare disks. If an I/O failure occurs, the hot-spare feature automatically 
relocates any redundant (mirrored or RAID 5) subdisks to the spare disk 
and restores the affected LSM objects and data. You are notified of the 


failure and relocation details by electronic mail. See Section 3.4.4 for more 
information on the hot-spare feature. 


If you designate a hot-spare disk, provide at least one per disk group. In the 
event of disk failure, the hot-spare disk automatically replaces the failed 
disk. Volumes can use hot-spare disks only from within the same disk group. 


To add a disk as a hot-spare disk: 

1. In the Object Tree, select Disk Group and in the Object Table, select the 
LSM disk to be designated as a hot-spare disk. 
Choose Properties from the Disk Groups menu. 
In the Disk Properties window: 


Select the General tab. 
. Select Spare. 
c. Click on Ok. 


Note 


The Properties dialog box is associated with the disk you 
have highlighted when you choose Properties. If you 
select a different disk from the Object Table, you must 
open a new Properties dialog box. 


A.3.2 Evacuating a Disk 


You can evacuate (or move) the contents of the volumes to other disks in the 
same disk group if there is sufficient free space. If no target disk is specified, 
LSM uses available disks with sufficient free space. Evacuating a disk is 
useful in the event of disk failure. 
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If the disk being evacuated contains part of a mirrored, striped, or RAID 5 
volume, do not move the contents of the disk to another disk containing a 
copy of the mirrored volume or part of the striped/RAID 5 volume. 


To evacuate a disk from LSM control: 

1. Inthe Object Tree, select Disk and in the Object Table, select the disk 
that contains the objects and data to be moved. 

2. Fromthe Disk menu, choose Evacuate. 
The Evacuate dialog box is displayed: 


| Evacuate Disk @ servername.com 


Disk Name: ‘rootdg/swap01 Browse... 


Target Disk(s): Browse... 


Ok Apply Cancel Help 


3. Inthe Evacuate Disk dialog box: 


a. If thecorrect disk name is not displayed in the Disk Name field, 
type the disk name or click on Browse then click on the Object 
Tree to select the disk. 


b. Type the name of the target disk to which you want to move the 
contents of the evacuated disk or click on Browse then click on the 
Object Tree to select one or more target disks. 

If you choose Browse, the total evacuated space (in kilobytes) is 
displayed so you can choose your target disk accordingly. 


c. Click on Ok. 


A.3.3 Mirroring a Disk 


You can mirror a disk to provide high availability for the volumes on that 
disk. Mirroring also improves read performance, because multiple reads 
to the same volume can be done simultaneously using the multiple copies 
of data. 


If possible, mirror a disk onto a disk on a different bus to reduce the risk of a 
single point of failure for the volume. 
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To mirror all concatenated volumes on a disk: 


1. Inthe Object Tree, select Disk and in the Object Table, select the disk 
that contains the volumes to be mirrored onto another disk. 


2. Fromthe Disk menu, choose Mirror. 
The Mirror Disk dialog box is displayed: 


Mirror Disk @ servername.com 


Disk Name: {ootdg/swap01 Browse... 


Target Disk{s): Browse... 


Ok Apply Cancel Help 


3. Inthe Mirror Disk dialog box: 
a. Ifthecorrect disk nameis not displayed in the disk name field, type 
the disk name or click on Browse to Select the disk. 


If you choose Browse, the total space being mirrored is displayed so 
you can choose your target disk accordingly. 


b. Tospecify the disks to contain the new mirrors, type the target disk 
name or click on Browse and complete the Target Disk dialog box. 


c. Click on Ok. 


A.3.4 Placing a Disk On Line 


Placing a disk on line restores access to a disk that is off line. The disk is 
placed in the free disk pool and is accessible to LSM again. After bringing 
a disk back online, the disk must be added to a disk group before it can 
be used for volumes. 


Only disks that are off line can be placed on line. 
To place a disk on line: 


1. Inthe Object Tree, select Disk and in the Object Table, select the disk to 
be brought on line. 
2. Fromthe Disks menu, choose Online. 


The Online Disk dialog box is displayed. 
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3. Inthe Online Disk dialog box: 


a. If thecorrect disk name is not displayed, type the disk name or 
click on Browse to select the disk. 


b. Click on Ok. 


A.3.5 Recovering Volumes on a Disk 


A recovery operation depends on the types of volumes on the disk and 
includes starting disabled volumes, resynchronizing mirrors in mirrored 
volumes, and resynchronizing parity in RAID 5 volumes. After successful 
recovery, the volumes should be available for use. 


Alert icons and the Alert Monitor window might provide information when a 
volume recovery is needed. 


If recovery of a volume is not possible, restore the volume from backup. 
To recover all volumes on a disk: 


1. Inthe Object Tree, select Disk and in the Object Table, select the disk 
that contains the volumes to be recovered. 
2. Fromthe Disks menu, choose Recover. 
The Recover Disk dialog box is displayed. 
3. Inthe Recover Disks dialog box: 
a. If thecorrect disk name is not displayed, type the disk name or 
click on Browse to select the disk. 
b. Click on Ok. 


A.3.6 Removing a Disk from an LSM Disk Group 


An LSM disk no longer in use can be removed from a disk group. Do 

not remove LSM disks that are currently in use (for example, disks that 
contain subdisks for a volume); doing so can result in loss of data or of data 
redundancy. 


After an LSM disk is removed from a disk group, it is still initialized for 
use with the LSM software. Therefore, after removing the disk froma disk 
group, it can be either immediately added to another disk group, removed 
from LSM, or left for later use. 


To remove a disk from an LSM disk group: 


1. Inthe Object Tree, select Disk and in the Object Table, select the disk 
to be removed. 


2. Fromthe Disks menu, choose Remove. 
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3. 


The Remove Disk dialog box is displayed: 


| Remove Disk @ servername.com | _]| 


Disk Name: Jusk3 Browse... 
Evaruate Target Disks... 
After removing disk: 


Retten to Free Disk Pasi 
@ Retin fo Uninitializai State 


Ok Apply Cancel Help 


In the Remove Disk dialog box: 
a. If thecorrect disk name is not displayed, enter the disk name or 
click on Browse to select the disk. 


b. To move the contents of the disk to another disk before the disk is 
removed, select Evacuate. Click Target Disks to specify one or more 
disks to which you want the contents moved. 


c. Specify how to handle the disk after removal: 


To remove the disk from its disk group and place it in the free disk 
pool, select Return to Free Disk Pool. The disk remains under 
LSM control. 


Toremovethe disk from LSM control, select Return to Uninitialized 
State. 


d. Click on Ok. 


A.3.7 Renaming a Disk 


Because disk access names are defined by the operating system and media 
names are defined by you, you can rename only disk media names for disks 
in a disk group. 


To rename the disk media name for an LSM disk: 


1. 


In the Object Tree, select Disk and in the Object Table, select the disk 
to be renamed. 


From the Disks menu, choose Rename. 
The Rename Disk dialog box is displayed. 
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3. Inthe Rename Disk dialog box: 
a. If thecorrect disk name is not displayed, enter the disk name or 
click on Browse to select the disk. 
b. Enter the new LSM disk name. 
c. Click on Ok. 


A.3.8 Replacing a Disk 


You can replace an existing disk with a new physical disk, move volumes to 
the new disk, and attempt to recover any redundant (mirrored or RAID 5) 
volumes on the disk. You cannot recover nonredundant volumes. You should 
restore nonredundant volumes from backup. If the disk being replaced is 

a boot disk, you can set up the new disk as a boot disk. You might need to 
replace a disk if the disk fails and needs to be removed and repaired. 


If you replace a good disk, you need to remove the disk from its disk group 
and place it in the free disk pool before you replace the disk. If you replacea 
disk that has failed and is disconnected, you do not need to remove the disk 
from the disk group. 


To replace a disk: 


1. Inthe Object Tree, select Disk and in the Object Table, select the disk 
to be replaced. 
2. Fromthe Disks menu, choose Replace. 


The Replace Disk dialog box is displayed: 


Replace Disk @ servername.com 


Disk Name: idsk0e Browse... 


New Physical Disk: | Browse... 


Ok Apply Cancel Help 


3. Inthe Replace Disk dialog box: 
a. If thecorrect disk nameis not displayed, enter the LSM disk name 
for the disk to be replaced or click on Browse to Select the disk. 


b. Enter the physical disk name for the new (replacement) disk or 
click on Browse to select a disk. 


c. Click on Ok. 
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A.3.9 Scanning for New Disks 


You can search your configuration for disks that are not under LSM control. 
Disks that are found are added to the free disk pool. 


To scan for a new disk: 

1. Select a disk from the Object Table and choose Add... from the Disks 
menu. 
Click on the Scan Disk button. 

2. To view disks that are found, click on Free Disk Pool in the Object Tree. 


A.3.10 Taking a Disk Off Line 


You can take a disk off line to prevent LSM from accessing it. You must 
remove a disk from its disk group before you take it off line. An offline disk 
remains unavailable until you restore access to the disk by placing it on line. 


You take a disk off line to protect it from unintentional use, for example, if 
attempts to access it might have a negative effect on the system. You cannot 
take a disk that is in use off line. 


To take a disk off line: 


1. Inthe Object Tree, select Disk and in the Object Table, select the disk 
to be taken offline. 
2. Fromthe Disks menu, choose Offline. 
The Offline Disk dialog box is displayed. 
3. Inthe Offline Disk dialog box: 
a. If thecorrect disk name is not displayed, enter the disk name or 
click on the Browse button to select the disk. 
b. Click on Ok. 


A.4 Managing Disk Groups 


The following sections describe disk group management tasks that you can 
complete using the Storage Administrator. 


A.4.1_ Adding a Disk to a Disk Group 
To add a disk toa disk group, follow the instructions for adding a disk 


as described in Section A.3.1, and in the Add Disk dialog box, specify an 
existing disk group. 
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TheLSM disk name must be unique within the disk group. If multiple disks 
are specified in the Disk Device(s) field and only one disk name is specified 
in the Disk Name(s) field, LSM appends numbers to the disk name so that 
each disk name is unique within its disk group. 


You must place disks that belong to a disk group in the free disk pool before 
you can add them to another disk group. You must add disks in the free disk 
pool to a disk group before you can use them to create volumes. 


Disks must be on line before they can be added to a disk group or the free 
disk pool. Disks cannot be added to deported disk groups. 


You must place the root disk in the root disk group (rootdg). If the root disk 
is placed in any other disk group, you cannot use the root disk to boot the 
system. 


A.4.2 Creating a Disk Group 


You must place disks into a disk group before you can use them to create 
volumes. The default disk group (rootdg) is created during LSM installation 
and always exists on a system running LSM. You can create additional disk 
groups to organize your disks into logical sets. 


Each new disk group must contain at least one disk and must have a unique 
name. You can use only disks that are online and do not already belong toa 
disk group to create a disk group. 


To create a disk group: 


1. From the Console menu, choose New then Disk Group. 
The New Disk Group dialog box is displayed: 


New Disk Group @ servername.com 


Disk Group Name: / View... 
Scan Disks 
Disk Device(s): ‘dskOd Browse... 
Options: 
Disk Name(s): | 


Comment: § 


Ok Apply Cancel Help 
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2. Inthe New Disk Group dialog box: 
a. Enter the name of the disk group to be created. Click View to view 
the names of existing disk groups. 


b. Toset up any new disks on the system, click Scan Disks. This runs 
the disk setup commands appropriate for the operating system. 


c. Select the disk devices to be placed in the new disk group or click 
on Browse to select the devices. 


d. Thereare two options: 


To specify the LSM disk name for the disk, enter a disk namein 
the Disk Name(s) field. If noLSM disk nameis specified, Storage 
Administrator assigns a default name to the disk. 


Enter a comment if desired. 
e. Click on Ok. 


A.4.3  Deporting a Disk Group 


After a disk group is created, the LSM software automatically imports it for 
use whenever the system is booted. 


To disable access to a diSk group, you deport the disk group. You must stop 
all the volumes within the disk group before deporting it. 


To deport a disk group: 
Select the Storage Administrator (at the top of the Object Tree). 


From the Disk Group menu, choose Deport... 
The Deport Disk Group dialog box is displayed: 


Deport Disk Group @ servername.com 


Disk Group Name: Jama Browse... 


Expert Options 


New Host: = 


New Name: | 


Ok Apply Cancel Help 
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3. Inthe Deport Disk Group dialog box: 


a. Ifthecorrect disk group name is not displayed, enter the disk group 
name or click on Browse to select the disk group. 


b. Usethe following Expert Options with caution: 


To change the name of the disk group at deport, enter a new disk 
group name in the New Name field. 


To set up a host machine to import the deported disk group at 
reboot, enter the host ID in the New Host field. 


c. Click on Ok. 


A.4.4 Importing a Disk Group 


You can import a disk group to make a deported (inaccessible) disk group 
and its volumes accessible again. To import a deported disk group, you 
must know the disk group’s former name and this disk group name must 
have remained unused. In addition, at least one disk formerly assigned to 
the deported disk group must remain unused. If all disks associated with 
a deported disk group were reused because the disk group was deported, 
that disk group cannot be imported. 


The import might fail for a number of reasons. It might fail if the host 
cannot find one or more disks in the disk group. If the import fails because 
a disk has failed, you can import the disk group by selecting the F orce 
Import expert option. If the import fails for another reason, a forced import 
can cause serious problems. 


When you import a disk group, the system stamps its host |D on all disks 

in the disk group. A disk group import fails if one of the disks is stamped 
with a host |D that does not match the others. This ensures that dual-ported 
disks cannot be managed (and possibly corrupted) by two systems at the 
same time. If you are sure that the disk group is not in use by another host, 
you can clear the host |Ds and import the disk group by selecting the Clear 
Host ID expert option. 


To import a disk group: 


1. Select the Storage Administrator (at the top of the Object Tree), then 
select Disk Group from the Object Table 
2. Fromthe Disk Group menu, choose! mport Disk Group... 


Thelmport Disk Group dialog box is displayed: 
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Expert Options 


Import Disk Group @ servername.com 


Disk Group Name: [GroupR Browse... 


Start All Volumes 
Clear Host ID 
Force Import 


New Name: / 


Use New Name as Temporary 


Ok Apply Cancel Help 


3. Inthelmport Disk Group dialog box: 


a. 


e. 


If the correct disk group name is not displayed, enter the disk group 
name or click on Browse to select the disk group. 


Use the following Expert Options with caution: 


To start all volumes in the disk group at import, select Start All 
Volumes. 


To clear the existing host |D stamp on all disks in the disk group at 
import, select Clear Host |D. Do not use this option if another host 
is using any disk in the disk group. 


To force the disk group import when the host cannot access all disks 
in the disk group, select Force! mport. Usethis option with caution. 


Enter the name of the disk group to be imported or click on Browse 
to select the disk group. 


To change the name of the disk group at import, enter a new disk 
group name in the New Name field. To indicate that the name 
change is temporary, select Use New Name as Temporary. If you 
indicate a temporary name change, the original name is returned 
when the system is rebooted. 


Click on Ok. 


A.4.5 Destroying a Disk Group 


You can destroy a disk group permanently to remove the group from LSM 
control. It reinitializes all of the disks in the disk group as empty disks and 
places them in the free disk pool for reuse. You cannot destroy a disk group 
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if any volumes in that disk group arein use. When a disk group is destroyed, 
the volumes in the disk group are removed. 


Destroy a disk group only if you are sure that you nolonger need the volumes 
and data in the disk group. Because the last disk in an existing disk group 
cannot be removed, destroying a disk group is a way to free the last disk ina 
disk group for reuse. 


You cannot destroy the rootdg disk group. 
To destroy a disk group: 


Select the Storage Administrator (at the top of the Object Tree). 
From theSystem menu, choose Destroy Disk Group. 
The Destroy Disk Group dialog box is displayed. 
3. Inthe Destroy Disk Group dialog box: 
a. Enter thename of thedisk group to be destroyed or click on Browse 
to select the disk group. 
b. Click on Ok. 


A.4.6 Moving a Disk Group 


You can move a disk group (and LSM objects in that disk group) from one 
system to another. LSM and the Storage Administrator (server) must be 
running on both systems. 


To move a disk group from one system to another: 


Unmount and stop all volumes in the disk group to be moved. 


Follow the instructions in Section A.4.3 to deport the disk group to be 
moved to the other system. 


3. Attach all of the physical disks in the disk group to the new system. 


On the new system, follow the instructions in Section A.4.4 to import 
the disk group. 

5. Select the Storage Administrator (at the top of the Object Tree) and 
from the System menu, choose Scan Disks to set up the newly attached 
disks on the system. This runs the disk setup commands appropriate 
for the operating system. 

6. Follow the instructions in Section A.4.7 to restart and recover all 
volumes in the disk group on the new system. 
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A.4.7 Recovering Volumes in a Disk Group 


You can recover volumes in a given disk group. The recovery operations 
depend on the types of volumes in the disk group and include starting 
disabled volumes, resynchronizing mirrors in mirrored volumes, and 
resynchronizing parity in RAID 5 volumes. After successful recovery, the 
volumes are available for use. 


Alert icons and the Alert Monitor window might provide you information to 
know when volume recovery is needed. 


In some cases, recovery might not be possible. If the volume recovery fails, 
you can attempt to restore the volume from backup. 


To recover all volumes in a disk group: 
1. Inthe Object Tree, select Disk Group and in the Object Table, select the 
disk group containing the volumes to be recovered. 
2. Fromthe Disk Group menu, choose Recover. 
The Recover Disk Groups dialog box is displayed. 
3. Inthe Recover Disk Groups dialog box: 
a. Enter the name of the disk group to be recovered or click on Browse 
to select the disk group. 
b. Click on Ok. 


A.4.8 Renaming a Disk Group 
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You can rename a disk group. If volumes in the disk group are in use 
(mounted), the disk group is not renamed. Renaming a disk group updates 
the /etc/fstab file. 


The new disk group name must be unique. 
To rename a disk group: 


1. Inthe Object Tree, select Disk Group and in the Object Table, select the 
disk group to be renamed. 
2. From the Disk Group menu, choose Rename. 


The Rename Disk Group dialog box is displayed: 
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Rename Disk Group @ servername.com 


Disk Group Name: Tugtcl Browse... 


New Name: : 


Ok Apply Cancel Help 


3. Inthe Rename Disk Group dialog box: 
a. Ifthecorrect disk group nameis not displayed, enter the disk group 
name or click on Browse to select the disk group. 
b. Enter the new name for the disk group. 
c. Click on Ok. 


A.5 Managing Subdisks 


Subdisks are created as the result of creating a volume. You cannot use the 
Storage Administrator to create subdisks. 


The following sections describe the subdisk management tasks that you can 
complete by using the Storage Administrator. 


A.5.1 Joining Subdisks 


You can join two or more subdisks to forma single, larger subdisk. Subdisks 
can be joined only if they belong to the same volume and occupy adjacent 
regions of the same disk and mirror. The joined subdisk can retain the name 
of one of the subdisks being joined. 


For a volume with a striped plex, the subdisks must bein the same column. 


To join subdisks: 
1. In the Object Tree, select Volume and in the Object Table, select the 
volume with the subdisks to be joined. 
From the Volume menu, choose Show Layout. 
In the Volume Layout Details window, hold down the Shift key and click 
to select the subdisks to be combined. Subdisks must be contiguous. 
a. Fromthe Subdisk menu, choose J oin. 
TheJ oin Subdisk dialog box is displayed: 
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Join Subdisks @ servername.com 


Disk Group Name: ‘GrsA 


Source Subdisks: |dsk3a-01 Browse... 


Target Subdisk Name: | 


Ok | Apply | Cancel | Help | 


b. In theJ oin Subdisks dialog box: 


Enter the name of the disk group that contains the subdisks to 
be joined. 


If the correct subdisk names are not displayed, enter the subdisk 
names or click on Browse to select the subdisks. Specify at least 
two subdisk names separated by a space. 


Enter the name of the new, combined subdisk. 
Click on Ok. 


4. Closethe Volume Layout Details window. The new volume layout can 
be viewed by reopening the window. 


A.5.2 Moving a Subdisk 


You can move portions of a volumetoa different disk toimprove performance. 
The disk space occupied by the original subdisk is returned to the free space 
pool. 


Do not move a subdisk in a mirrored, striped, or RAID 5 volume toa disk 
that already contains a copy or part of that volume. 


If this task fails and leaves some unused subdisks (that is, subdisks that are 
not associated with a volume) on the system, you can remove the subdisk 
(see Section A.5.3) to free the space occupied by the unused subdisks. 


To move a subdisk: 


1. In the Object Tree, select Volume and in the Object Table, select the 
volume with the subdisk to be moved. 


From the Volume menu, choose Show Layout. 


In the Volume Layout Details window, select the subdisk to be moved 
to another disk. 


a. Fromthe Subdisk menu, choose Move. 
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The Move Subdisks dialog box is displayed: 


Move Subdisks @ servername.com 


Disk Group Name: | 


Source Subdisks: | Browse... 
Target Disk Name: © Browse... 
-Expert Options 

Move Policy 


One to One (—~ 


One to One: Contiguous _) 


Split as Required _) 


Starting Offset for Gap Search: 5 


Ok | Apply | Cancel | Help | 


In the Move Subdisks dialog box: 


Enter the name of the disk group that contains the subdisk to be 
moved. 


If the correct source subdisk name is not displayed, enter the 
subdisk’s name or click on Browse to select the subdisk. 


Enter the name of the target disk to which the subdisk should be 
moved or click on Browse to select a disk. 


Choose the Move Policy to specify whether the subdisk can be split 
into smaller subdisks that fit in available space(s) on the target 
disk. The One to One options do not split the subdisk. The Split as 
Required option allows the subdisk to be split if needed. 


Specify the minimum disk offset for the subdisk. Enter the offset 
in the Starting Offset for Gap Search field. 
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c. Click on Ok. 
4. Closethe Volume Layout Details window. You can view the new volume 
layout by reopening the window. 


A.5.3 Removing a Subdisk 


You can remove a subdisk that is not associated with a volume. This returns 
the disk space occupied by unused subdisks to the free space pool. 


To remove a subdisk: 


1. Inthe Object Tree, select Disk and in the Object Table, select the volume 
with the subdisk to be removed. 


2. Fromthe Volume menu, choose Show Layout. 
In the Volume Layout Details window, select the subdisk to remove. 
From the Subdisk menu, choose Remove. 
The Remove Subdisks dialog box is displayed: 


Remove Subdisks @ servername.com 


Disk Group Name: — 


Subdisks: | Browse... 


Ok | Apply | Cancel | Help | 


In the Remove Subdisks dialog box: 


Enter the name of the disk group that contains the subdisks to be 
removed. 


If the correct subdisk names are not displayed, enter the subdisk names 
or click on Browse to select the subdisks. 


Click on Ok. 


5. Close the Volume Layout Details window. You can view the new volume 
layout by reopening the window. 


A.5.4 Splitting a Subdisk 


You can divide a subdisk into two or more subdisks. Once split, the smaller 
subdisks can be moved elsewhere or rejoined later. This is useful for 
reorganizing volumes or for improving performance. The original subdisk 
must contain a sufficient number of sectors for the specified split to work. 
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The name of the first subdisk remains the same as the selected subdisk. 
Other subdisks are automatically named by the Storage Administrator. The 
new, smaller subdisks occupy the same regions of the disk that the original 
subdisk occupied. 


A log subdisk cannot be split. 
To split a subdisk into multiple subdisks: 


1. In the Object Tree, select Volume and in the Object Table, select the 
volume with the subdisk to be split. 
From the Volume menu, choose Show Layout. 
In the Volume Layout Details window, select the subdisk to be split into 
multiple subdisks. 
a. Fromthe Subdisks menu, choose Split. 
The Split Subdisk dialog box is displayed: 


Split Subdisk @ servername.com 


Subdisk Name: Jdskr2z Browse... 


Number of Target Subdisks: 2 


Ok | Apply | Cancel | Help | 


b. Inthe Split Subdisk dialog box: 


If the correct subdisk name is not displayed, enter the subdisk’s 
name or click on Browse to select the subdisk. 


Enter the number of subdisks into which the subdisk should be 
split. A subdisk can be split into two or more subdisks. 


Click on Ok. 
4. Closethe Volume Layout Details window. You can view the new volume 
layout by reopening the window. 
A.6 Managing Volumes 


The following sections describe the volume management tasks that you can 
complete by using the Storage Administrator. Most tasks described in this 
section are appropriate only for UFS. 


AdvFS file domains (file systems) operate differently from UFS file 
systems. Once you assign a volume to AdvFS, it is out of the control of 
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the Storage Administrator. Therefore, you cannot stop, remove, rename, 
mount, or unmount an AdvFS volume. That is, you cannot use the Storage 
Administrator to perform tasks that compromise the integrity of the AdvFS 
file domain. 


In aduster, AdvFS file systems are supported in all modes; UFS file systems 
are supported in read-only mode. 


A.6.1 Analyzing Activity on Volumes, Disks, and Subdisks 
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You can use the Volume to Disk Mapping window to display information 
about the performance of volumes, disks, and subdisks. 


The statistical values for the performance data are represented by different 
colors. When the analysis starts or changes, the color behind the object will 
change. Clicking on any of the green dots in the table highlights the path 

between the volume and its related disks. Statistics can be collected only on 
volumes. Only disks and subdisks associated with volumes can be analyzed. 


You can open Volume to Disk Mapping windows for more than one disk 
group; however, only one disk group can be analyzed at a time. 


To open the Volume to Disk Mapping window: 
1. In the Object Tree, select disk groups and in the Object Table, select 
the disk to map. 


Right-click on a disk group in the Object Table and choose Disk/Volume 
Map... from the pop-up menu. 


The Volume to Disk Mapping window is displayed: 
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ale] 


Disk Group: rootdg 


Yolunes 


vol01 


|__| 


/ jinitial_disk 
initial_disk-01 (0 : 20480) 
initial_disk-02 (20480 : 20480) 


<gap> (40960 : 4068480) 


Disks 


In the Volume to Disk Mapping window: 


a. 


To display all of the subdisks and gaps on a particular disk, click 
the arrow to the left of the disk name. 

To select a disk, subdisk or volume for analysis, click on the name 
of that object. The background for the object changes color when 
selected. 


To view the volumes, disks, or subdisks that are associated, click on 
the green dot at the intersection between the disk and volume. 


To analyze the use of an object, select a volume, disk, or subdisk 
and choose a command from the Analyze... menu: 

Start Analysis—Adds the selected item(s) to the list of objects being 
analyzed. The selected items begin to display information about 
their performance characteristics. 

Stop Analysis—T he selected items will return to their normal 
state (colors disappear) while all other items being analyzed will 
continue to display their performance characteristics. 

Analyze All—Starts analysis on all volumes and LSM disks in 

a view. 
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Stop All—Stops analysis for all items in all views. Once this 
happens all items return to their normal state (the colors 
disappear). 


Parameters—Opens the Analysis Parameters dialog box, which lets 
you set the high and low threshold values for each object under 
analysis. 


Note 


When you choose the Start Analysis and Stop Analysis 
command on the Analyze menu, you must have selected 
an object. When you choose the Analyze All command 
you need not select an object. 


e. Tosee the Statistics form showing numerical equivalents for the 
colors, right-click on the volume or disk being analyzed. 


f. Tousethe pop-up menu for volumes, disks, or subdisks, right-click 
on the disk or volume object. 


g. Toclose the Volume to Disk Mapping window, choose Close from 
the Console menu. 


A.6.2 Adding a File System to a Volume 


You can place a new file system on an existing volume and mount the file 
system. If Mount at Boot is selected, the /etc/fstab file is automatically 
updated. 


To add a file system to an existing volume: 


1. In the Object Tree, select Volume and in the Object Table, select the 
volume to contain the file system. 
2. Fromthe Volume menu, choose File System then New. 


The New File System dialog box is displayed: 
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New File System @ servername.com 


Volume Name: group1/volg21 Browse... 
Mount Point: [volg21 FS Type — 
_advts 
}¥ Mount at Boot C ufs 


Mount Details... 


Mkfs Details... 


Domain Name:| 


Fileset:| 


Ok | Apply | Reset | Cancel | Help | 


In the New File System dialog box: 


a. 


If the correct volume name is not displayed, enter the volume name 
or click on Browse to select the volume. 


Type the mount point for the file system. The mount point must be 
an absolute pathname (that is, it must begin with root (/)). Ifthe 
path specified for the mount point does not exist, it is created. 


Select Mount at Boot if desired. 
Select the file system type: 
If you select AdvFS, enter the Domain Name and the Fileset name. 


To add a volume to an existing AdvFS domain, you must have an 
AdvFS Advanced Utilities license. If you supply an existing domain 
name and do not havea license, an error message is displayed. You 
can create a new domain for the volume without the Advanced 
Utilities license. 


If you select UFS, you can also select Extra Options in the Mkfs 
Details dialog box. Click on Help in the Mkfs Details dialog box for 
more information. This option is not available in a cluster. 


Click on Mount Details to make the file system read-only or to add 
extra options. Click on Help in the Mount Details dialog box for 
more information. 


Click on Ok. 


The Storage Administrator A-29 


A.6.3 Adding a Log to a Volume 
You can add a log toa mirrored or RAID 5 volume. 


When you add a log toa mirrored volume, dirty region logging (DRL) is 
activated for that volume. DRL uses the log to track the regions of the 
volume that change due to1/O writes. If a system failure occurs, DRL uses 
the information in the log to recover only the portions of the volume that 
need recovery. This speeds up recovery time for mirrored volumes. 


For DRL to bein effect, a mirrored volume must have at least one DRL log. 
You can create additional DRL logs (on different disks) to mirror the DRL 
information. 


A RAID 5 volume log speeds up the resynchronization time for RAID 5 
volumes after a system failure. A RAID 5 log maintains a copy of the data 
and parity being written tothe volume at any given time. If a system failure 
occurs, LSM can replay the RAID 5 log to resynchronize the volume. This 
copies the data and parity that was being written at the time of failure from 
the log to the appropriate areas of the RAID 5 volume. 


You can create multiple RAID 5 logs (on different disks) to mirror the log 
information. Ideally, each RAID 5 volume should have at least two logs. 


To add a log to a volume: 


1. In the Object Tree, select Volume and in the Object Table, select the 
volume to contain the log. 
2. Fromthe Volumes menu, choose Log then Add. 


The Add Log dialog box is displayed: 


Add Log @ servername.com 


Volume Name: Yyootdg/vol-dskOd Browse... 


Disk Name: | Browse... 


Ok Apply Cancel Help 


3. Inthe Add Log dialog box: 


a. If thecorrect volume nameis not displayed, enter the volume name 
or click on the Browse button to select the volume. 


b. Toplace the log on a specific disk, enter the name of the disk in the 
Disk Name field or click on Browse to Select a disk. 
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C. 


Click on Ok. 


A.6.4 Adding a Mirror to a Volume 


You can create a mirror (copy) of a volume on a disk that is not being used. 
Once mirrored, the data in the volume is redundant. If a disk fails, the data 
remains available on the surviving mirror. A volume can have multiple 
mirrors, but each must reside on a separate disk. Sufficient disk space must 
be available. You cannot mirror a RAID 5 volume. 


You can use only disks in the same disk group to create a new mirror. If 

no disks are assigned, LSM uses available disk space to create the mirror. 
Adding a mirror requires resynchronization, so this task might take some 
time. 


A volume can contain up to 32 mirrors. 


To add one or more mirrors to an existing volume: 


1. 


In the Object Tree, select Volume and in the Object Table, select the 
volume to be mirrored. 


From the Volumes menu, choose Mirror then Add. 
The Add Mirror dialog box is displayed: 


Add Mirror @ servername.com 


Volume Name: |rootdg/rootval Browse... 


Layasi... | Assign Disks... 


Ok Apply Cancel Help 


In the Add Mirror dialog box: 


a. 


If the correct volume name is not displayed, enter the volume name 
or click on Browse to select the volume. 


Click on the Layout button to: 


¢ Specify the layout for the mirror (concatenated or striped) and, 
if striped, the stripe unit size. 


e« Add morethan one mirror and supply comments. 


Click on the Assign Disks button to place the mirror on a specific 
disk. 


Click on Ok. 
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A.6.5 Disabling a Mirror in a Volume 


You can disable a mirror to temporarily detach the mirror from its volume. 
However, this can result in a loss of data redundancy because the mirroring 
process is not occurring. A detached mirror is inaccessible for reads and 
writes, but is still associated with its volume. 


Once disabled, the mirror remains detached from its volume until you either 
reattach the mirror or restart the volume. If a volume has only two mirrors 
and one mirror is disabled, the volume is not redundant while the mirror 

is disabled. 


The last mirror in a volume cannot be disabled. 


When a volume is restarted, any disabled (detached) mirrors are reattached 
to the volume automatically. 


To disable a mirror in a volume: 


1. Inthe Object Tree, select Volume and in the Object Table, select the 
volume that contains the mirror to be disabled. 


2. Fromthe Volumes menu, choose Mirror then Disable. 
The Disable Mirror dialog box is displayed: 


Disable Mirror @ servername.com 


Select a mirror to disable: 


anewgroup/vol01 -01 


Name | Size | Type | State al 
* vol01-01 10.0M Concatenated Attached 
& vol01-02 10.0M Concatenated Attached 
_O& | Apply | Caneel | Help | 


3. Inthe Disable Mirror dialog box: 


a. Select the mirror to be disabled. 
b. Click on Ok. 
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A.6.6 Repairing a Mirror in a Volume 


You can repair a disabled mirror and reattach it to its volume. Repairing 
a mirror involves copying data from an active mirror on the volume to the 


mirror being attached. Once attached, the mirror is accessible for reads and 


writes. This task recovers the mirror so that it has the same contents as 
other mirrors in the volume. 


Alert icons and the Alert Monitor window might provide you with 
information when a mirror needs to be repaired. 


Depending on the amount of data in the volume, this task might take some 


time. 


To repair a mirror: 


1. 


In the Object Tree, select Volume and in the Object Table, select the 
volume that contains the mirror to be repaired. 


From the Volumes menu, choose Mirror then Repair. 
The Repair Mirror dialog box is displayed: 


Repair Mirror @ servername.com 


Select a mirror to repair: 


anewgroup/vol01-01| 


Name | Size | Type | State 


< vol01-01 10.0M Concatenated Failed rn 


Ok | Apply | Cancel | Help | 


In the Repair Mirror dialog box: 


a. Select the mirror to be repaired. 
b. Click on Ok. 
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A.6.7 Checking a File System on a Volume 


Checking a file system applies only to UFS file systems because it uses the 
fsck utility, which is not compatible with AdvFS file systems. You can check 
the file system with or without repairing it. Checking a file system might 
take some time. 


If you are running a cluster, UFS file systems are mounted read-only, so the 
Storage Administrator cannot check the file system. 


To check a UFS file system on a volume: 


1. Fromthe Object Tree, select File System and in the Object Table, select 
a UFS file system. 


2. Fromthe File Systems menu, choose Check. 
The Check File System dialog box is displayed: 


Check File System @ servername.com 
Volume Name: | Browse... 


Fsck Options Mount Options 


@ Unrnount and check, Yien maigit 


@ Check with no repair 
Unrnpunt and cheek 


Check and repair 


v 


Ok | Apply Cancel Help 


3. Inthe Check File System dialog box: 

a. If the correct file system name is not displayed, enter the file 
system name or click on Browse to select the file system. 

b. Choose the fsck option: 
e¢ Check with no repair 
¢ Check and repair 

c. Choose the mount option: 
e Unmount and check then mount 
e« Unmount and check 

d. Click on Ok. 
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A.6.8 Creating a Copy of Volume Data 


You can create a shapshot (temporary mirror) of a volume that tracks volume 
activity. In a cluster, you cannot take a snapshot of the clusterwide root. 


To create or stop a volume snapshot: 


1. From the Object Tree, select Volume and in the Object Table, select a 
volume for which to create or stop a snapshot. 
2. Fromthe Volumes menu, choose Snapshot. 


The Volume Snapshot dialog box is displayed: 


Volume Snapshot @ servername.com 


Volume Name: group1/volg21 Browse... 
Snapshot Name: [snapshotvolg21 Assign Disks... 
Snapstart | Snapshe? Remove Snapshot Mirror 


hid Click Snapstart to create the snapshot mirror. 


3. Inthe Volume Snapshot dialog box: 
a. If thecorrect volume nameis not displayed, enter the volume name 
or click on Browse to select the volume. 
b. If the correct snapshot name (volume) is not displayed, enter the 
volume name or click on Assign Disks to select the volume. 
4. You can create the mirror, start, or stop it: 
¢ Click on the Snapstart button to create the snapshot mirror. 


* Click on the Snapstop button to stop the snapshot process and create 
a new volume to attach to the snapshot mirror so you can access it. 


¢ Click on the Remove Snapshot Mirror button to remove the volume 
that was created. 


A.6.9 Creating a Volume 
You can create a volume that is less than or equal to the available free 


space on the disks. If no disks are assigned, the Storage Administrator uses 
available space on disks in the selected disk group. 
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The data in a striped or concatenated volume is not protected against disk 
failure unless the volume is mirrored. 


To create a volume: 


1. From the Console menu, choose New then Volume. 
The New Volume dialog box is displayed: 


New Volume @ servername.com 


Disk Group Name: group1 Browse... 


Volume Name: ‘yol01 


Comment: | 
Size: | “Maxsize | 
Layout Mirror Info 
_| Mirrored 
( Coneatenated ,. Neer og 
a Number of Columns: 7 Yotal Namber of Mirrors: 

_)Striped aneineee ; 
_)RAID-5 ripe Unit Size: 


_| Enable Logging 


Assign Disks... Disks: Group201 
Add File System... File System: None 


hid Concatenated: A simple volume with a single copy of data on one or more disks. 


Ok | Apply | Reset | Cancel | Help | 


2. Inthe New Volume dialog box: 
a. Ifthecorrect disk group nameis not displayed, enter the disk group 
name or click on Browse to select the disk group. 
b. Accept the default new volume name or enter a new volume name. 
c. Enter a comment if desired. 
Enter the volume size. 


To specify a size unit, attach an s (sectors), k (kilobytes), m 
(megabytes), or g (gigabytes) to the size. The default size unit is 
sectors. 


To determine the largest possible size for the volume, click M axsize. 
Units are displayed in kilobytes. 
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e. Choose the volume layout: 
¢ Concatenated 
e Striped—Enter the number of columns and stripe unit size. 


¢ RAID 5—Enter the number of columns and stripe unit size. 
This option is not available in a cluster. 


f. If you have chosen a concatenated or striped volume, you can 
choose to mirror it. 


To mirror the volume, select Mirrored. In the Total Number of 
Mirrors field, type the total number of mirrors for the volume. Note 
that each plex is a mirror, soif you create a volume and one mirror 
of that volume, the total number of mirrors is 2. 


g. Check the Enable Logging box to create logging for mirrored or 
RAID 5 volumes. 


h. To place the volume on a specific disk, click Assign Disks. Select 
the disk you want to use from the Space Allocation-N ew Volume 
dialog box and click on Ok. 


i. Toplacea file system on the volume, click Add File System. 
j. In the Add File System dialog box: 
i. Typethe mount point for the file system. The mount point 
must be an absolute pathname; that is, it must begin with root 


(/). If the path specified for the mount point does not exist, it 
will be created. 


ii. Select Mount at Boot if you want the /etc/fstab file 
automatically updated and the file system mounted at reboot. 


iii. Select the file system type. If you select AdvFS, enter the 
Domain Name and the Fileset name. If you select UFS, you 
can also select Extra Options in the Mkfs Details dialog box. 
This option is not available in a TruCluster environment. 


Click on Mount Details to make the file system read-only or to add 
extra options. Click on Help in the Mount Details dialog box for 
more information. 


Click on Ok to dose the Add File System dialog box. 
k. Click on Ok. 
A.6.10 Mounting a UFS File System on a Volume 


You can mount an existing UFS file system on a volume. If Mount at Boot is 
selected, the /etc/fstab file is automatically updated. 
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To mount a file system on an existing volume: 


1. 


In the Object Tree, select Volume and in the Object Table, select the 
volume that contains the UFS file system to be mounted. 


From the Volumes menu, choose File System then Mount. 
The Mount File System dialog box is displayed: 


Mount File System @ servername.com 


Volume Name: group1/volg21 Browse... 


Mount Point: | 
}¥ Mount at Boot 


Mount Details... 


fy A mount point is required. 


Ok | Apply | Cancel | Help | 


In the Mount File System dialog box: 
a. If thecorrect volume nameis not displayed, enter the volume name 
or click on the Browse button to select the volume. 


b. Enter the mount point for the file system. The mount point must be 
an absolute pathname; that is, it must begin with root (/). If the 
path specified for the mount point does not exist, it is created. 


c. Select Mount at Boot if desired. 


Click on Mount Details to make the file system read-only or to add 
extra options. Click on Help in the Mount Details dialog box for 
more information. 


e. Click on Ok. 


Note 


AdvFS file sets do not appear as mounted on volumes because 
AdvFS does not associate file sets with a specific volume. 


A.6.11 Preparing to Restore a Volume from Backup 


To restore a volume from backup, you can stop the volume, set the volume to 
an uninitialized state, and restart the volume (without resynchronizing the 
volume’s mirrors). This procedure will not work for an AdvFS file domain. 
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A.6.12 


If the volume contains a mounted UFS file system, you must unmount the 
file system before you proceed. This task does not remount the file system. 


This procedure is useful for disaster recovery. If a volume’s data is corrupted 
and you need to restore the volume from backup, this procedure prepares 
the volume for restoration. 


To prepare a volume to restore it from backup: 
1. In the Object Tree, select Volume and in the Object Table, select the 
volume to be restored from backup. 
2. Fromthe Volumes menu, choose Prepare F or Restore. 
The Prepare Volume F or Restore dialog box is displayed. 
3. Inthe Prepare Volume F or Restore dialog box: 
a. If thecorrect volume nameis not displayed, enter the volume name 
or click on Browse to select the volume. 
b. Click on Ok. 


Recovering a Volume 


You can recover a volume. The recovery operations depend on the type of 
volume and include starting disabled volumes, resynchronizing mirrors in 
mirrored volumes, and resynchronizing parity in RAID 5 volumes. After 
successful recovery, the volume should be available for use. 


Alert icons and the Alert Monitor window might provide information when a 
volume recovery is needed. 


In some cases, recovery might not be possible. If the volume recovery fails, 
you can attempt to restore the volume from backup. 


To recover a failed volume: 
1. In the Object Tree, select Volume and in the Object Table, select the 
volume to be recovered. 
2. Fromthe Volumes menu, choose Recover. 
The Recover Volume dialog box is displayed. 
3. Inthe Recover Volume dialog box: 
a. If thecorrect volume nameis not displayed, enter the volume name 
or click on the Browse button to select the volume. 
b. Click on Ok. 
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A.6.13 


A.6.14 


Removing a Volume 


Removing a volume destroys all of the datain that volume. Removea volume 
only if you are sure that you do not need the data in the volume (or the data 
is backed up elsewhere). When a volume is removed, the space it occupied 

is returned to the free space pool. 


Removing a volume that has a file system on it will work only if the file 
system is UFS. 


To remove a volume: 


1. In the Object Tree, select Volume and in the Object Table, select the 
volume remove. 

2. Fromthe Volumes menu, choose Remove. 
The Remove Volume dialog box is displayed. 


3. Inthe Remove Volume dialog box, click on the Yes button to remove 
the volume. 


Removing a Log from a Volume 


You can remove a DRL logor a RAID 5 log froma volume. 


If you remove a volume’s only log, logging (either DRL or RAID 5 logging) 
is no longer in effect for that volume. If logging is disabled, recovery time 
increases. 


To remove a log from a volume: 


1. In the Object Tree, select Volume and in the Object Table, select the 
volume that contains the RAID 5 or DRL log to be removed. 
2. Fromthe Volumes menu, choose Log then Remove. 


The Remove Log dialog box is displayed: 


Remove Log @ servername.com 


Select a log to remove: 


Name Size | Type | State | Columns | Stripe Unit | = 
 volg22-01 o.0M DRL Attached Oo Oo 


Ok | Apply | Cancel | Help | 
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A.6.15 


A.6.16 


3. In the Remove Log dialog box: 
a. If thecorrect volume nameis not displayed, enter the volume name 
or click on the log table to select the volume. 
b. Click on Ok. 


Removing a Mirror from a Volume 


Removing a mirror from a volume breaks the link between the mirror and 
its volume and returns the mirror’s disk space to the free space pool for 
reuse. However, this might leave the volume unmirrored and unprotected 
against disk failure. 


If a volume has only two mirrors and one mirror is removed, the volume is 
no longer redundant. The last mirror cannot be removed from a volume, for 
that is equivalent to removing the volume. 


To remove a mirror from a volume: 
1. In the Object Tree, select Volume and in the Object Table, select the 
volume that contains the mirror to be removed. 


2. Fromthe Volumes menu, choose Mirror then Remove. The Remove 
Mirror dialog box is displayed. 


3. Inthe Remove Mirror dialog box: 


a. Ifthecorrect mirror nameis not displayed, enter the mirror name. 
b. Click on Ok. 


Renaming a Volume 


When you rename a volume, the new name must be unique within the disk 
group. If the volume has a file system, renaming the volume automatically 
updates the /etc/fstab file and allows you to specify a new mount point 
for the file system. You cannot rename volumes that are part of an AdvFS 
domain. 


To rename a volume: 


1. In the Object Tree, select Volume and in the Object Table, select the 
volume to be renamed. 
2. Fromthe Volumes menu, choose Rename. 


The Rename Volume dialog box is displayed: 
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Rename Volume @ servername.com 


Volume Name: ‘group1/vol-dsk3c Browse... 


New Name: | 


Ok | Apply | Cancel | Help | 


3. Inthe Rename Volume dialog box: 
a. If thecorrect volume nameis not displayed, enter the volume name 
or click on Browse to select the volume. 
b. Enter the new name for the volume. 
c. Click on Ok. 


A.6.17 Resizing a Volume 


You can increase or decrease the size of a volume. If the volume contains a 
UFS file system, this procedure also resizes the file system, which destroys 
the data in it. A volume containing an unmounted file system cannot be 
shrunk. 


You cannot resize an AdvFS file domain with the Storage Administrator. 
If you want to resize a domain, use the AdvF S command line commands 
addvol and rmvol. See AdvFS Administration for more information. 


You can specify either the desired size or the amount of space to add to or 
subtract from the volume size. When a volume is shrunk, the resulting extra 
space is returned to the free disk pool. When the volume size is increased, 
sufficient disk space must be available. When increasing the size of a 
volume, LSM assigns the necessary new space from available disks. 


To resize a volume: 


1. In the Object Tree, select Volume and in the Object Table, select the 
volume to be resized. 
2. Fromthe Volumes menu, choose Resize. 


The Resize Volume dialog box is displayed: 
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Resize Volume @ servername.com 


Volume Name: igroup I/vol-dsk3c Browse... 

Current Size:| 1001.397 M Assign Disks... 
Add By: © 
Subtract By: | 


Desired Size: | 


v 


Ok | Apply | Cancel | Help | 


3. Inthe Resize Volume dialog box: 


a. If thecorrect volume nameis not displayed, enter the volume name 
or click on Browse to select the volume. 


b. Tousea specific disk for the additional space, click Assign Disks and 
select the disk you want to use from the Space Allocation-Resize 
dialog box. 


c. Specify one of the following: 


¢« Toincrease the volume size by a specific amount of space, use 
the Add By field to specify how much space to add. 


¢ To decrease the volume size by a specific amount of space, use 
the Subtract By field to specify how much space to remove. 


¢ To specify the new volume size, type the size in the Desired 
Size field. 


¢ To specify a size unit, attach an s (Sectors), k (kilobytes), m 
(megabytes), or g (gigabytes) to the size. The default unit 
is sectors. 


4. Click on Ok. 


A.6.18 Starting a Volume 


You can start a volume. If you are not running a cluster, starting a RAID 5 
volume enables the volume and resynchronizes parity, if necessary. Starting 
a mirrored volume enables the volume and resynchronizes the mirrors to 
ensure that they are consistent. When a volume is successfully restarted, 
the volume is again available for use. 
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A.6.19 


A.6.20 


Under normal circumstances, volumes are automatically started when the 
system reboots. You can restart a volume that you stopped manually or 
to attempt to restart a volume that was stopped in some other manner. If 
you cannot start a volume, the volume remains unusable. If the volume 
contains an AdvFS file domain, you cannot start it using the procedure 
described below. 


To start a volume: 
1. In the Object Tree, select Volume and in the Object Table, select the 
(stopped) volume to be started. 
2. Fromthe Volumes menu, choose Start. 
The Start Volume dialog box is displayed. 
3. Inthe Start Volume dialog box: 
a. If thecorrect volume nameis not displayed, enter the volume name 
or click on the Browse button to select the volume. 
b. Click on Ok. 
The volume’s state in the Object Table changes to Started. 


Stopping a Volume 


You can stop a volume. When you stop a volume, it is not available for 
use until you restart it. You cannot stop a volume if it isin use or it has a 
mounted file system. If the volume contains an AdvFS file domain, you 
cannot stop it using the procedure described below. 


To stop a volume: 


1. In the Object Tree, select Volume and in the Object Table, select the 
volume to be stopped. 
2. Fromthe Volumes menu, choose Stop. 
The Stop Volume dialog box is displayed. 
3. Inthe Stop Volume dialog box: 
a. If thecorrect volume nameis not displayed, enter the volume name 
or click on the Browse button to select the volume. 
b. Click on Ok. 
The volume's state in the Object Table changes to Stopped. 


Unmounting a File System on a Volume 


You can unmount a mounted UFS file system. 
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To unmount a file system on a volume: 


1. 


In the Object Tree, select Volume and in the Object Table, select the 
volume containing the file system to be unmounted. 


From the Volumes menu, choose F ile System then Unmount. 

The Unmount File System dialog box is displayed. 

In the Unmount File System dialog box: 

a. If thecorrect volume nameis not displayed, enter the volume name 
or click on Browse to select the volume. 

b. Click on Ok. 
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Customizing the Storage Administrator 


This appendix describes how to track Storage Administrator activities, 
how to use the Storage Administrator, and how to customize the Storage 
Administrator GUI. See Appendix A for more information on using the 
Storage Administrator to complete a particular task for an LSM object. 


B.1 Tracking Storage Administrator Activities 


Three log files keep track of the Storage Administrator: 

« A command log tracks Storage Administrator tasks 

e« An access log tracks Storage Administrator |og-ins 

« A server log collects LSM startup information and error messages 


By default, a log maintenance shell script called /usr/lib/java/appli- 
cations/1smsa/logMaintenance runs once a week to save and compress 
each log file. Compressed files are saved as logfilename.gz.X, wherex 
is the version number. Each week the previous week’s saved file suffix is 
increased by one and a new logfilename.gz.1 is created. Files are saved 
for ten weeks. You can change the number of files to save by editing the 
root crontab file. 


B.1.1 Command Log File 


The command log file contains a description of each Storage Administrator 
task and information such as the user who performed the task, the task 
status, the start and finish times, and the commands used to perform the 
task. For failed tasks, the command l|og includes relevant error messages. 
By default, the command log is located in /var/1smsa/logs/command. 


The following output shows a sample command log entry for a successful 
volume creation: 

Create Volume 

Description: Create Volume 

User: root 


Started: Tue Mar 09 12:07:22 PDT 1999 
Finished: Tue Mar 09 12:07:24 PDT 1999 


State: Successful 
Executed Commands: 


/usr/sbin/volassist 
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-g rootdg make vol04 4m layout=striped stripeunit=128 ncolumn=2 


The following output shows a sample command log entry for a failed volume 
creation: 


Create Volume FAILED! 

Description: Create 

VolumeUser: root 

Started: Tue Mar 09 12:07:50 PDT 1999 
Finished: Tue Mar 09 12:07:51 PDT 1999 
State: Failed 


Executed Commands: 
/usr/sbin/volassist 
-g rootdg make vol05 8g layout=striped stripeunit=12 ncolumn=2 


Failed Command: /usr/sbin/volassist 
-g rootdg make vol05 8g layout=striped stripeunit=128 ncolumn=2 


Error Message: lsmsa:volassist: ERROR: Cannot allocate space 
for 16777216 block volume 


B.1.2 Access Log File 


You can monitor access to the Storage Administrator by reviewing the 
contents of the access log file. By default, the access log file is located in 
/var/lsmsa/logs/access. 


The following output shows a sample access log file entry: 


Mon Apr 05 12:07:22 PDT 1999: user rssn login succeeded 


Mon Apr 05 12:22:24 PDT 
1999; user jehg login failed with error *User password invalid* 


Entries for failed access might be logged multiple times due to a security 
requirement. 


B.1.3 Server Log File 


The server log tracks LSM startup information and server errors. By default, 
the server log file is located in /var/lsmsa/logs/server.log. 


The following output shows sample server log file entries: 


Starting Compaq Storage Administrator RMI Registry 
Starting Compaq Storage Administrator Command Server 
Starting Compaq Storage Administrator Server 

Fri Mar 12 11:22:21 PST 1999 

security enabled 

rebinding .... 

rebound 


//servername:2410/vrts.remote.vrtsServer 
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B.2 Working with Dialog Boxes 


Storage Administrator displays dialog boxes in which you provide 
information as shown in Figure B-1. Dialog boxes can contain selectable 
buttons or fields in which you enter information. Some dialog box fields 
contain default values that you can change. Items that are not applicable 
are grayed out. 


Figure B—1: Typical Storage Administrator Dialog Box 


New File System @ servername.com 


Volume Name: group1/volg21 Browse... 
Mount Point: |volg21 FS Type — 
_advis 
} Mount at Boot  ufs 


Mount Details... 


Mkfs Details... 


Domain Name:| 
Fileset:| 


Ok | Apply | Reset | Cancel | Help | 


To use a dialog box, select the appropriate items or enter the appropriate 
information in a field, then click on one of the following buttons to initiate or 
cancel the task: 


¢ Ok — Performs the current task and closes the dialog box. 


¢ Apply — Performs the current task and continues to display the dialog 
box. 


¢« Cancel — Closes the dialog box and cancels the current task. If you have 
already chosen Apply, use this button to close the dialog box. Doing so 
does not cancel the Apply request. 


e« Reset — Clears the information in dialog box fields. 
« Help — Displays the Help menu. 


B.2.1 Specifying Objects in Dialog Boxes 


Most Storage Administrator dialog boxes contain one or more object name 
fields. If you select an object before you select the task, the resulting dialog 
box usually includes the selected object name. If the object name field is 
empty, you can specify an object using one the following methods: 
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e Enter the object name. 


In some cases, you can specify multiple objects (separated by a space) 
in a single field. 


¢ Click on the Browse button next to the object name field, and then select 
the object from the resulting browse dialog box. Most browse dialog 
boxes display an Object Tree and Object Table. To select an object ina 
browse dialog box, click on an object group in the Object Tree, then click 
on the object in the Object Table. 


Note 


When you select an object for an action, the object name 
appears in the dialog box. This does not mean that the 
action you have chosen for that object is valid. If you try to 
complete an invalid operation on an object, an error message 
is displayed. 


B.2.2 Specifying Object Sizes in Dialog Boxes 


The following table shows the object sizes that you can enter to specify for an 
input field or a display size: 


For Enter 
Sectors Ss 
Kilobytes k 
Megabytes m 
Gigabytes g 


By default, sectors are used for input fields if you do not specify an input 
size or if you did not change the default value by customizing the GUI as 
described in Section B.3.4. By default, sizes are displayed in kilobytes unless 
you specify otherwise. 


B.3 Viewing Objects and Object Properties 


There are several windows and dialog boxes that you can use to display 
information about and perform LSM operations. 


B.3.1 Main Window 


The Object Tree and the Object Table track your LSM configuration. The 
Storage Administrator constantly monitors objects on the system and makes 
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appropriate changes to the displays. You can view objects in the Object Tree 
and Object Table in the following ways: 


¢ Click on the plus sign (+) or minus sign (-) next to an object to expand or 
collapse its hierarchy. 


¢ Click on the object type in the Object Tree. All objects that belong to the 
selected object appear in the Object Table. 


For example, to display all volumes in the rootdg disk group, expand the 
Disk Groups node (by clicking +), expand the rootdg node, and click on 
the Volumes group under rootdg. Only volumes in the rootdg disk group 
appear in the Object Table. 


¢« Todisplay the components of an object in the Object Table, double-click 
on the object. All objects that belong to that object appear in the Object 
Table. If the object does not contain other objects, the Properties dialog 
box appears. 


For example, to display the volumes in a disk group listed in the 
Object Table, double-click on the disk group name, then double-click on 
Volumes. All volumes in the disk group appear in the Object Table. 


e It might be useful to view a copy of the Object Table to look at different 
objects, for example, disks and volumes. From the Window menu choose 
Copy Object Table. A dynamic copy of the Object Table appears ina 
separate window. The contents of the new Object Table window continue 
to update. 


B.3.2 Volume Layout Details Window 


To display the Volume Layout Details window for a volume, highlight the 
volume in the Main window Object Table and choose Show Layout from the 
Volumes menu. 


The Volume Layout Details window displays a graphical view of the selected 
volume’s layout, components, and properties, as shown in Figure B-2. 
Figure B—2: Volume Layout Window 


Volume "vol-dsk0d" Layout Details @ servername.com 
View Selected Help 


Volume Concat Plex Subdisk___Disk Plex Length Offset Column _ Start 


£9 vol-dsk0d | f# vol-dskOd-01 = 
Size: 1.5 G Size: 1.5 G @% @ dskOd-01 dskOd-4.2BSD vol-dskOd-01 1.5G 0 0 


You can select objects or perform tasks on objects in the window. The Volume 
Layout Details window is not dynamic, so the objects displayed in the 
window are not automatically updated when the volume properties change. 
Choose U pdate from the View menu to refresh the display. To change the 
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volume displayed, choose Open from the View menu and specify another 
volume in the Open Volume dialog box. 


The View menu changes the display of the Volume Layout Details window. 
To hide the detailed information within each object, choose Compress 
Display from the View menu. Click on an object to show its details in the 
compressed display. 


To highlight objects that are related to or part of a specific object, choose 
Projection on Selection from the View menu, then click on an object. To 
highlight any subdisks on the same disk as a specific subdisk, choose 
Subdisk Projection from the View menu, then click on a subdisk. 


Right-click on an object to display its context-sensitive pop-up menu. 


B.3.3 Object Properties Dialog Boxes 


To view the properties of an object, click on the object in the Object Table 
and then choose Properties from the object’s menu. If the object contains no 
other objects, double-click on the object to display its Properties dialog box. 


The Object Properties dialog box displays detailed information specific to the 
selected object as shown in Figure B-3. 


Figure B-3: Volume Properties Dialog Box 


© 


General | Mirrors and Logs ] Disks | Alerts | 


Volume "vol-dsk3c" Properties @ servername.com 


Volume Name: vol-dsk3c Length: 1001,397 Mbytes 
Disk Group: group! State: Started 
Type: Concatenated 
Comment: | User: Foot 
Start Options: | Group: ‘system 


Read Policy: BasedonLayouts — Mode: Josoo 


Ok | Apply | Refresh Cancel | Help 


You can change some properties through this box. A set of tabbed pages 
provides information about the object and related objects. The tab labels and 
page contents vary, depending on the type of object selected. Click on the 
Help button for a detailed description of the Properties dialog box fields. 
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To change items in the Properties dialog box, make the changes, then click 
on the Ok button. This changes the settings for all properties tabs in the 
Properties dialog box. 


To update the contents of the Properties dialog box to reflect current 
properties for the object, click on the Refresh button. If you select a different 
object while a Properties dialog box is open, the contents of the dialog 

box does not change to reflect the new object selected. You must choose 
Properties again and open another dialog box. 


B.3.4 User Preferences Dialog Box 


You can change the way items appear in the Storage Administrator Main 
window and other windows. The Preferences dialog box contains a set of 
tabbed pages that display preference options for a particular aspect of 
Storage Administrator, as shown in Figure B-4. You can customize settings 
for a single Storage Administrator session or save the settings for future 
sessions. 


To display the Preferences dialog box, from the Options menu, choose 
Preferences or click the Prefs button on the toolbar. 
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Figure B—4: Preferences Dialog Box 


Preferences @ servername.com 


Tree/Table ] Toolbar ] Layout Details 
General ] Main Window ] Font ] Color ] Geometry 


Select text in field on enter: 
Show confirmation dialogs: 
Auto-save preferences on exit: 
Flush images: 


q@9eaa4 


Dynamic splitter: 


Default display unit: Megabytes — 


Summary decimal precision: 1 


Task decimal precision: 3 


Ok | Apply | Reset | Cancel | Help | 


To change preference settings, make the appropriate selections in the dialog 
box, then click on the Ok button. This changes the settings for all tabs in 
the Preferences dialog box. To reset the values for all tabs to the previous 
settings, click on the Reset button before you click on the Ok button. 


When you change preference settings, an asterisk appears on the tabbed 
page that contains changes. This icon disappears when you click on the Ok, 
Apply, or Reset button. When you click on the Apply or Reset button, an 
asterisk also appears in the Help bar status area. 


Unless you save your preferences, changes apply only tothe current session. 
To save your settings, choose Save Preferences from the Options menu and 
click on the Save button in the toolbar or click the asterisk in the Help 

bar status area. To reload your previously saved preferences, choose Load 
Preferences from the Options menu. 


The Storage Administrator saves user preferences in the 

user’s home directory/.1smsa/SApreference.prf file on the system 
where the client is running. If the autosave preference is set, Storage 
Administrator saves all preference settings when you exit the Storage 
Administrator session. 
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B.3.4.1 


B.3.4.2 


General Preferences 


The General tab window sets the preferences for: 


Select Text in Field on Enter 


Sets user input to replace mode. This highlights existing text in a field 
and replaces that text with the new text. 


Show Confirmation Dialogs 


Shows or hides confirmation dialog boxes for tasks that might have 
serious consequences (such as data loss). Confirmation dialogs require 
you to confirm that a task be performed. Confirmation dialogs typically 
appear for tasks that remove objects. If you hide confirmation dialogs, 
most tasks are performed immediately and without any confirmation. 


Auto-Save Preferences on Exit 


Saves all current user preferences when you exit the Storage 
Administrator. 


Flush Images 


Draws images slightly slower than usual to prevent the X server 
from growing. This is recommended if you plan to run the Storage 
Administrator for long periods of time. 


Dynamic Splitter 


Redraws the contents of the window panes while the splitter is being 
moved to resize the panes. 


Default Display Unit 


Sets the default size unit for areas that display object sizes. If Best 
Choice is set, the Storage Administrator uses an appropriate size unit. 


Summary Decimal Precision 


Sets the decimal point precision for object sizes displayed in the Object 
Table and other areas that display summaries. 


Task Decimal Precision 


Sets the decimal point precision for object sizes displayed in task-related 
dialog boxes and areas that display numerical information. 


Main Window Preferences 


The Main Window tab window sets the preferences for: 


Show Status Bar 


Show/hide the status bar (at the bottom of the Main window). The Status 
bar displays alert icons when failures or errors occur. 


Show Command Launcher 
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Shows or hides the Command Launcher. The Command Launcher 
displays a list of selectable tasks. You can show and hide the Command 
Launcher by checking and unchecking the Command Launcher box on 
the Window menu of the Main window. 


¢« Dock Command Launcher 
Attaches or detaches the Command Launcher and the Main window. 
¢ Docked Command Launcher Height 
Sets the height of the Command Launcher portion of the Main window. 


B.3.4.3 Font Preferences 


The Font tab window sets the font size, family, and style for: 
e User Font 


Sets the font for user input and objects displayed in the Object Tree 
and Object Table. 


e System Font 

Sets the font for the Storage Administrator labels, menus, and buttons. 
¢ Object Table Heading F ont 

Sets the font for Object Table headings. 
¢ Object Table Heading Highlight F ont 


Sets the font for the highlighted Object Table headings for sorting 
purposes. 


¢ Toolbar Font 
Sets the font for the toolbar buttons. 
¢ Graphical Display Font 
Sets the font for objects in the Volume Layout Details window. 


B.3.4.4 Color Preferences 


The Color tab window sets color preferences. Change colors by clicking on a 
color in the color wheel or by sliding the Red, Green, Blue, and Brightness 
Sliders. 


Colors can be set for: 
e Background Color 
Sets the background color for all the Storage Administrator windows. 
¢ Foreground Color 
Sets the color for foreground text in the Storage Administrator windows. 
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Tree/Table Color 

Sets the background color for the Object Tree and Object Table. 
Connecting Line Color 

Sets the color for the lines that connect items in the Object Tree. 
Selection Color 

Sets the color for selected items. 

Selection Foreground Color 

Sets the color for foreground text in selected items. 

Link Color 


Sets the color for links (Such as the links to tasks in the Command 
Launcher). 


Projection Color 


Sets the color for the lines that show object relationships in the Volume 
Layout Details window. 


B.3.4.5 Geometry Preferences 


The Geometry tab window sets the width and height (in pixels) for: 


Main window 

Object Search window 

Alert Monitor window 

Task Request Monitor window 
Volume Layout Details window 
Command Launcher window 
Object Table Copy window 


If you resize one of these windows, the new size is reflected in the Geometry 
preference for that window. 


B.3.4.6 Object Tree/Object Table Preferences 


The Tree/Table tab sets Object Tree and Object Table preferences for: 


Display Full Path 
Displays path information in the Object Tree and Object Table. 
Auto Scroll Table 


When an object is added or changed, scrolls through the objects until the 
new or changed object is visible in the Object Table. 
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¢ Splitter Position 


Moves the splitter to adjust the relative sizes of the Object Tree and 
Object Table panes. 


¢ Selector Tree/Table Width 


Sets the width (in pixels) of the Object Tree and Object Table for Browse 
dialog boxes that contain an Object Tree and a Object Table. 


¢ Selector Table Width 


Sets the width (in pixels) of the Object Table for Browse dialog boxes 
that contain only an Object Table. 


¢ Visible Selector Rows 
Sets the number of rows displayed in the Object Tree and Object Table in 
Browse dialog boxes. 


B.3.4.7 Toolbar Preferences 


The Toolbar tab window sets preferences for: 
¢ Show Toolbar 
Shows or hides the toolbar. 
¢ Position 
Places the docked toolbar at the top, bottom, or side of the Main window. 
¢ Presentation 
Displays graphics, labels, or both on the buttons in the toolbar. 


B.3.4.8 Layout Details Preferences 


The Layout Details window sets Volume Layout Details window preferences 
for: 
¢« Compress Display 
Compresses the graphical display of objects so that details are hidden. 
e Projection on Selection 


When an object is selected, highlights objects that are related to or 
part of that object. 


e Subdisk Projection 
When a subdisk is selected, highlights other subdisks on the same disk. 


B.3.5 Alert Monitor Window 


The Alert Monitor window displays information about failed objects or 
objects that experienced other errors, as shown in Figure B-5. Each object is 
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displayed with a description of the failure or error. When an object fails and 
an alert occurs, the alert icon appears on the Status bar of the Main window 
and also overlays the object’s icon in the Object Table. 


Figure B—5: Alert Monitor Window 


Alert Monitor 


Alert Help 


Object | Description 
& anewgroup/vold vol01-01: detached plex =| 


To display the Alert Monitor window either: 
¢ Click the Alert button in the toolbar 

¢« Choose Alerts from the Window menu 

¢ Click on the Alert icon on the Status bar 


To view the properties of an object with an alert, select the object and choose 
Object Properties from the Alert menu. You can also access the object 
Properties dialog box by right-clicking and choosing Properties from the 
pop-up menu or by double-clicking on the object. 


B.3.6 Object Table Copy Window 


A copy of the Object Table allows you to view different parts of your system 
at the same time. The windows are dynamic, so updates to the system are 
reflected in all windows. To display the window copy, choose the Table button 
from the toolbar, or from the Window menu choose Copy Object Table. 


B.3.7 Search Window 


The Search window searches the system for objects that match the specified 
search criteria. The Search window contains a set of tabbed pages that 
display search options for a particular type of object, as shown in Figure B-6. 
You can select the type of objects to search for by clicking on the tab label. 
The search will take place only on objects of the type you have selected. 


To display the Search window, click the Search button in the toolbar or from 
the Window menu choose Search. 
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Figure B-6: Search Dialog Box 


Object Search 
Console Window Selects Help 


Volumes | Disks} File systems | Disk Groups | 


Search Criteria 


Any Name: 


Any Disk Group: J | ~ 


Any Size 


Specify the search criteria by choosing the drop-down menu selection then 
entering your criteria. If you enter criteria in more than one box, the search 
results reflects only the items that match all of the criteria (Boolean AND). 


Thetablein the bottom half of the Search window displays objects and their 
properties that match the search criteria. (If you do not see the search 
results, drag the bottom edge of the window to enlarge the display.) Objects 
displayed in the Search window are monitored and removed from the window 
if they no longer meet the current search criteria. 


The Search window has menus similar to those in the Main window 
menu. The Window menu opens other windows or a copy of the current 
search-results table. The context-sensitive Selected menu accesses tasks or 
properties for a object selected in the table. You can right-click on an object 
to access a context-sensitive pop-up menu. To close the Search window, 
choose Close from the Console menu. 


B.3.8 Task Request Monitor Window 


The Task Request Monitor window shows LSM and other tasks that the 
Storage Administrator performed in the current session (and any other 
sessions running on the system) as shown in Figure B- 7. Each task is listed 
with properties such as the user who performed the task, the task status, 
and thestart and finish times. For failed tasks, the Task Properties window 
includes any relevant error messages. 


To display the Task Request Monitor, click on the Task button (in the 
toolbar), or from the Window menu choose Tasks. 
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Figure B—7: Task Request Monitor Window 


Console Yasks Help 


Task User State | Start Time | —_Finish Time =| 
Create Disk ( root Successful March 13, 2000 10:52 March 13, 2000 10:5 a 


To remove finished tasks and to close the window, from the Console menu 
choose Remove Finished Tasks. 


To view the low-level commands used to perform a task, choose Properties 
fromthe Tasks menu. You can copy commands from the E xecuted Commands 
field of the Tasks Properties dialog box tothe command line or toa script file. 


B.4 Shortcuts and Other Operations 


There are shortcuts that let you more efficiently perform operations with 
the GUI. 


B.4.1 Sorting Objects 


To sort the objects in a table column, click on the column heading. To reverse 
the order of the objects, click on the column heading again. The sort order 
cannot be saved with other user preferences. 


You can sort entries in the Object Table, the Command Launcher, the Search 
window, and the Task Request Monitor window. 


B.4.2 Clearing an Alert 


To acknowledge and clear an alert icon displayed on the Status bar, choose 
Clear Alert Status from the Options menu. 


B.4.3 Keyboard Shortcuts 


You can use the following keyboard shortcuts instead of menu commands: 
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Table B—1: Keyboard Shortcuts 


Keystrokes Action 

Ctrl-Shift-V Create a volume 

Ctrl-G Create a disk group 

Ctrl-F Create a file system 

Ctrl-Z Resize an object 

Ctrl-N Rename an object 

Ctrl-Shift-R Remove an object 

Ctrl-P Show the properties of an object 
Ctrl-L Show the layout of a volume 


(graphical view) 


The following shortcuts work only in the Main window: 


Table B—2: Main Window Keyboard Shortcuts 


Keystrokes Action 

Ctrl-R Open the Task Request Monitor window 
Ctrl-A Open the Alert Monitor window 

Ctrl-S Open the Search window 

CtrI-C Close the window 


B.4.4 Docking the Toolbar and Command Launcher 


To separate the toolbar from the Main window, place the pointer over the 
toolbar handle (the thin bar next to the toolbar) and drag the toolbar outside 
the window. You can also use the toolbar handle to move the toolbar to the 


bottom, side, or top of the Main window. 


To separate or attach the Command Launcher and the Main window, choose 
Preferences from the Options menu. In the Preferences dialog box, choose 
the Main Window tab and click on Dock Command Launcher. To separate 
the Command Launcher, click on the Dock Command Launcher again to 


remove the check mark. 
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C 


Using the voldiskadm Menu Interface 


This appendix describes the voldiskadm menu interface that you can use 
to perform LSM disk and disk group operations. The menus are easy to 
use and provide information about each step to help you decide the correct 
response for each prompt. 


C.1 Starting the voldiskadm Menu Interface 
To start the voldiskadm menu interface, enter: 
# voldiskadm 
An interactive menu (Figure C-1) is displayed. 


Figure C—1: Main Menu for the LSM voldiskadm Interface 


Logical Storage Manager Support Operations 
Menu: VolumeManager/Disk 


1 Add or initialize one or more disks 

2 Encapsulate one or more disks 

3 Remove a disk 

4 Remove a disk for replacement 

5 Replace a failed or removed disk 

6 Mirror volumes on a disk 

7 Move volumes from a disk 

8 Enable access to (import) a disk group 
9 Remove access to (deport) a disk group 
10 Enable (online) a disk device 

Lv Disable (offline) a disk device 

12 Mark a disk as a spare for a disk group 
13 Turn off the spare flag on a disk 

14 Recover plexes and volumes after disk replacement 
list List disk information 

? Display help about menu 

2? Display help about the menuing system 
gq Exit from menus 


Select an operation to perform: 
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C.2 Disk Management 
This section describes the disk management tasks available with the 
voldiskadm menu interface. 


C.2.1 Initializing a Disk 


Disk initialization identifies a disk toLSM and prepares the disk for LSM 
use. This operation involves installing a disk header and writing an empty 
configuration database on the disk. A disk access record is created for the 
disk, unless such a record already exists. 


Note 


A disk must contain a disklabel before you can initialize it for 
LSM use. 


To initialize a disk for use with the LSM software: 

1. At the main menu prompt, select menu item 1 to run the Add or 
initialize one or more disks operation. 
The Add or initialize disks screen appears. 


2. Enter the disk access name of the disk to be added. If you do not know 
the access name of the disk you want to add, enter the letter 1 or type 
the word list at the prompt. LSM displays a list of the known disks on 
the system. For example: 


Select disk devices to add: 


[<space-separated disk list>,<disk>,list,g,?] list 


DEVICE DISK GROUP STATUS 
dsk2 dsk2 rootdg online 
dsk3 dsk3 rootdg online 
dsk4 dsk4 rootdg online 
dsk5 dsk5 rootdg online 
dskeé a = online 
dsk7 - = online 
dsk8 = 3S unknown 


Select disk devices to add: 
[<space-separated disk list>,<disk>,list,q,?] 


3. Enter the name of the disk group you want the disk to be a part of: 
Which disk group [<group>,none,list,g,?] (default: rootdg) 
You can: 
e Press Return to accept the default disk group name, rootdg. 
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Specify the name of a disk group to add the disk to an existing disk 
group. 

Create a new disk group and add the disk toit. To create a new disk 
group, enter a disk group name that does not yet exist. 


Specify no disk group and leave the disk available for use by future 
add or replacement operations. To leave the disk available for future 
use, enter a disk group name of none. Enter none if: 


- Thedisk group you want the disk to be a part of does not exist 
yet. 


- You want to keep this disk available as a spare to be used as a 
replacement disk. 


4. Depending on your response to the Which disk group... prompt, LSM 
displays one of the following screens. 


If you entered none, LSM displays the following prompts: 
Which disk group [<group>,none,list,qg,?] (default: rootdg) none 


The disk will be initialized and left free for use as a replacement 
disk. 


dsk8 


Continue with operation? [y,n,q,?] (default: y) [Return 


The following disk device has a valid disk label, but does not appear to 
have been initialized for the Logical Storage Manager. If there is 

data on the disk that should NOT be destroyed you should encapsulate 

the existing disk partitions as volumes instead of adding the disk 

as a new disk. 


dsk8 
Initialize this device? [y,n,q,?] (default: y) [Return 
Initializing device dsks8. 


If you selected rootdg as the disk group, LSM displays the following 
prompts: 


Which disk group [<group>,none,list,q,?] (default: rootdg) [Return 


The default disk name that will be assigned is: 


disk01 


Use this default disk name for the disk? [y,n,q,?] (default: y) [Return 


Add disk as a spare disk for rootdg? [y,n,q,?] (default: n) [Return 


The selected disks will be added to the disk group rootdg with the 
default disk names. 


dsk8 


Continue with operation? [y,n,q,?] (default: y) [Return 


The following disk device has a valid disk label, but does not appear to 
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have been initialized for the Logical Storage Manager. If there is 
data on the disk that should NOT be destroyed you should encapsulate 
the existing disk partitions as volumes instead of adding the disk 
as a new disk. 


dsk8 


Initialize this device? [y,n,q,?] (default: y) [Return 


Initializing device dsks8. 


Adding disk device dsk8 to disk group rootdg with disk 
name disk0l. 


5. Press Return to continue. 

e IfLSM successfully completes the disk initialization, the following 
prompt appears: 

Add or initialize other disks? [y,n,q,?] (default: n) 

e If the fstype column in the disk’s disk label information contains 
anything other than unused, LSM displays a message asking you to 
confirm or cancel the operation: 

- Ifthe fstypein the disk label of the specified partition or an 
overlapping partition is set, LSM displays a warning message to 
inform you that initializing the disk might destroy existing data. 

- If you are sure that the disk partition has no valid data and that 
the partition can be added to LSM, you can ignore the warning 
message and answer y tothe prompt. The voldiskadm utility 
then proceeds to initialize the disk partition and add it toLSM. 

- If the disk cannot be initialized because the specified partition 
or an overlapping partition on the disk is open (that is, a 
partition is actively in use by UFS, AdvFS, LSM, or swap), the 
initialization process fails and voldiskadm issues an error 
message informing you of the problem. 


6. Press Return to return tothe main menu. 


C.2.2 Displaying Disk Information 
To find information about disks available on the system: 
1. Atthemain menu prompt, enter the letter 1 or typethe word list to 
display a list of disks available on the system. 


LSM displays a list of devices similar to the following and prompts you 
to enter the address (name) of the disk for which you want to obtain 
detailed information: 


Select an operation to perform: list 


List disk information 
Menu: VolumeManager/Disk/ListDisk 


C-—4 Using the voldiskadm Menu Interface 


Use this menu operation to display a list of disks. 


You can 


also choose to list detailed information about the disk at 
a specific disk device address. 


Enter disk device or "all" 


DEVICE 
dsk2 
dsk3 
dsk4 
dsk5 
dské 
dsk7 
dsk8 


2. Enter the addresses (names) of all the disks for which you want detailed 


[<address>,all,q,?] (default: 
DISK GROUP STATUS 
dsk2 rootdg online 
dsk3 rootdg online 
dsk4 rootdg online 
dsk5 rootdg online 
- - online 
- = online 
disk0l1 rootdg online 


information (in this case, dsk8): 


Device to list in detail 


Device: 
devicetag: 
type: 
hostid: 
disk: 
group: 
flags: 
pubpaths: 
privpaths: 
version: 
iosize: 
public: 
private: 
update: 
headers: 
configs: 
logs: 


[<address>,none,q,?] (default: 
dsk8 

dsk8 

sliced 

servername 

name=disk01 id=922907065.1771.servername 
name=rootdg id=921709207.1025.servername 
online ready autoimport imported 
block=/dev/disk/dsk8g char=/dev/rdisk/dsk8g 
block=/dev/disk/dsk8h char=/dev/rdisk/dsk8h 
2y1 

min=512 (bytes) max=32768 (blocks) 

slice=6 offset=16 len=4106368 

slice=7 offset=0 len=4096 

time=922907069 seqno=0.5 

0 248 

count=1 len=2993 

count=1 len=453 


Defined regions: 


config priv 17- 247[ 231]: copy=01 
config priv 249- 3010[ 2762]: copy=01 
log priv 3011- 3463[ 453]: copy=01 
List another disk device? [y,n,q,?] (default: n) 


3. Press Return to return tothe main menu. 


C.2.3 Adding a Disk to a Disk Group 


You might want to add a new disk to an existing disk group. Perhaps 
the current disks have insufficient space for the project or work group 
requirements, especially if these requirements have changed. 


To add a disk to a disk group: 


1. Follow the instructions documented in steps 1 and 2 in Section C.2.1. 
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all) 


none) 


Return 


dsk8 


offset=000000 enabled 
offset=000231 enabled 
offset=000000 enabled 


2. When the add disk operation adds a disk toa diSk group, LSM checks 
whether the disk is already initialized. If the disk is initialized, LSM 
displays the following screen and prompts you to reinitialize the disk: 


Which disk group [<group>,none,list,g,?] (default: rootdg) dgl 
The default disk name that will be assigned is: 


dgl101 


Use this default disk name for the disk? ly,n,q,?] (default: y) [Return 


Add disk as a spare disk for dgl? l[y,n,q,?] (default: n) [Return 


The selected disks will be added to the disk group dgl with the 
default disk names. 


dsk8 


Continue with operation? [y,n,qg,?] (default: y) [Return 


The following disk device appears to have been initialized already. 
The disk is currently available as a replacement disk. 


dsk8 


Use this device? [y,n,q,?] (default: y) |Return 


The following disk you selected for use appears to already have 
been initialized for the Logical Storage Manager. If you are 
certain the disk has already been initialized for the Logical 
Storage Manager, then you do not need to reinitialize the disk 
device. 


dsk8 


Reinitialize this device? [y,n,q,?] (default: y) 


Use the information in the following table to determine whether or not you 
should reinitialize the disk. 


If... Then... 

The disk is new Initialize the disk before placing it 
under LSM control. 

The disk was previously in use Do not initialize the disk. Instead, use 

and contains useful data the LSM encapsulation function to place 


the disk under LSM control while still 
preserving the existing data. 


The disk was previously in use but Initialize the disk before placing the 
it does not contain useful data disk under LSM control. 
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C.2.4 Moving Volumes from a Disk 


Before you disable or remove a disk, you might want to move the data from 
that disk to other disks on the system. Use this operation immediately prior 
to removing a disk, either permanently or for replacement (Section C.2.5). 


Note 


Simply moving volumes off a disk without also removing the disk 
does not prevent volumes from being moved onto the disk by 
future operations. For example, two consecutive move operations 
could move volumes from one disk to another and then back. 


Make sure the other disks in the disk group have sufficient space 
available. 


To move volumes from a disk: 


1. Select item 7 from the main menu. 


2. Fromthe Move volumes from a disk screen, enter the name of the disk 
whose volumes you want to move: 


Use this menu operation to move any volumes that are using a 

disk onto other disks. Use this menu immediately prior to 
removing a disk, either permanently or for replacement. You can 
specify a list of disks to move volumes onto, or you can move the 
volumes to any available disk space in the same disk group. 


NOTE: Simply moving volumes off of a disk, without also removing 
the disk, does not prevent volumes from being moved onto 
the disk by future operations. For example, using two 
consecutive move operations may move volumes from the 
second disk to the first. 


Enter disk name [<disk>,list,q,?] dsk5 
3. Enter the name of the disk that the volumes should be moved to: 
You can now specify a list of disks to move onto. Specify a list 
of disk media names (e.g., rootdg01) all on one line separated by 
blanks. If you do not enter any disk media names, then the volumes 
will be moved to any available space in the disk group. 


Enter disks [<disk ...>,list,q,?] dsk4 


Requested operation is to move all volumes from disk dsk5 in 
group rootdg. 


NOTE: This operation can take a long time to complete. 


Continue with operation? [y,n,q,?] (default: y) [Return 


As LSM moves the volumes from the disk, it displays the status of the 
operation: 


Move volume v1 ... 
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When the volumes have all been moved, LSM displays the following: 


Evacuation of disk dsk5 is complete. 
Move volumes from another disk? [y,n,q,?] (default: n) 


4. Press Return toreturn tothe main menu. 


C.2.5 Removing a Disk from a Disk Group 


This operation involves removing the LSM disk associated with the selected 
partitions from LSM control by removing the associated disk access records. 
The voldiskadm menu interface provides two methods for removing disks 
from a disk group: 


e Menu item 3, Remove a disk—Removes a disk completely from LSM 
control and does not retain the disk name. 


« Menu item 4, Remove a disk for replacement—Removes a failed disk and 
retains the disk name so it can be replaced with another disk. 


See Section C.2.4, which describes how to move data from a disk to another 
disk on the system, and Section C.2.6, which describes how to replace a 
failed or removed disk. 


Note 


You must disable the disk group before you can remove the last 
disk in that group. Disabling a disk group, also referred to as 
deporting a disk group, is described in Section C.3.2. 


C.2.5.1 Removing a Disk Without Replacement 
To remove a disk from its disk group: 


1. Select item 3 from the main menu. 

LSM displays the Remove a disk screen. 

2. Enter the name of the disk to be removed (in this case, dsk5): 
Use this operation to remove a disk from a disk group. This 
operation takes, as input, a disk name. This is the same name 
that you gave to the disk when you added the disk to the disk 
group. 

Enter disk name [<disk>,list,q,?] dsk5 


3. Confirm the operation by pressing Return at the verification prompt: 


Requested operation is to remove disk dsk5 from group rootdg. 


Continue with operation? [y,n,q,?] (default: y) [Return 


LSM removes the disk from the disk group and then displays the 
following when the operation has completed: 
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Removal of disk dsk5 is complete. 
Remove another disk? [y,n,q,?] (default: n) 


4. Press Return toreturn tothe main menu. 


C.2.5.2 Removing a Disk for Replacement 


You might occasionally need to replace a disk in a disk group. This operation 
involves initializing the disk for LSM use and replacing the old disk and 
associated disk media records with the new disk and its information. 


To replace a disk while retaining the disk name: 


1. Select item 4 from the main menu. 
LSM displays the Remove a disk for replacement screen: 
Use this menu operation to remove a physical disk from a disk 
group, while retaining the disk name. This changes the state 
for the disk name to a "removed" disk. If there are any 
initialized disks that are not part of a disk group, you will be 
given the option of using one of these disks as a replacement. 


Enter disk name [<disk>,list,q,?] 


2. Enter the name of the disk to be replaced if you know it. Otherwise, 
enter the letter 1 for a list of disks, and then enter the disk name at 
the prompt. 


e |f the operation does not need to disable a volume to replace the 
disk, the following is displayed: 


The following volumes will lose mirrors as a result of this 
operation: 


vi 
No data on these volumes will be lost. 


e If the operation must disable a volume to replace the disk, the 
following is displayed: 


The following volumes will be disabled as a result of this 
operation: 


tst 
These volumes will require restoration from backup. 


Are you sure you want to do this? [y,n,q,?] (default: n) 


3. Confirm the operation by entering y and pressing Return. 


4. \|fthere are any initialized disks available that are not part of a disk 
group, LSM displays the following screen and gives you the option of 
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6. 


using one of these disks as a replacement. Select the replacement disk 
from the list provided. Press Return if you want to use the default disk. 


The following devices are available as replacements: 
dsk5 


You can choose one of these disks now, to replace dsk4. 
Select "none" if you do not wish to select a replacement disk. 


Choose a device, or select "none" 
[<device>,none,q,?] (default: dsk5) [Return 


Confirm the operation by pressing Return: 


Requested operation is to remove disk dsk4 from group rootdg. 
The removed disk will be replaced with disk device dsk5. 


Continue with operation? [y,n,q,?] (default: y) [Return 


When LSM successfully replaces the disk, LSM displays the following 
screen: 


Removal of disk dsk4 completed successfully. 
Proceeding to replace dsk4 with device dsk5. 
Disk replacement completed successfully. 


Remove another disk? [y,n,q,?] (default: n) 


Press Return to return to the main menu. 


C.2.6 Replacing a Failed or Removed Disk 


To replace a disk that you removed with the Remove a disk for replacement 
menu operation or a disk that failed during use: 


1. 
2. 


Select item 5 from the main menu. 


Enter the name of an uninitialized disk to replace the failed or removed 
disk: 


Replace a failed or removed disk 
Menu: VolumeManager/Disk/ReplaceDisk 


Use this menu operation to specify a replacement disk for a disk 
that you removed with the "Remove a disk for replacement" menu 
operation, or that failed during use. You will be prompted for 

a disk name to replace and a disk device to use as a replacement. 
You can choose an uninitialized disk, in which case the disk will 
be initialized, or you can choose a disk that you have already 
initialized using the Add or initialize a disk menu operation. 


Select a removed or failed disk [<disk>,list,q,?] list 
Disk group: rootdg 
DM NAME DEVICE TYPE PRIVLEN PUBLEN STATE 


dm dsk5 - - - - NODEVICE 
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Select a removed or failed disk [<disk>,list,q,?] dsk5 


Select disk device to initialize [<address>,list,g,?] list 


DEVICE DISK GROUP STATUS 
dsk2 dsk2 rootdg online 
dsk3 dsk3 rootdg online 
dsk4 dsk4 rootdg online 
dsk5 = 3 online 
dsk10 = = unknown 


Select disk device to initialize [<address>,list,q,?] dsk10 


The following disk device has a valid disk label, but does not appear to 
have been initialized for the Logical Storage Manager. If there is 

data on the disk that should NOT be destroyed you should encapsulate 

the existing disk partitions as volumes instead of adding the disk 

as a new disk. 


dsk10 


Initialize this device? [y,n,q,?] (default: y) [Return 


The requested operation is to initialize disk device dsk10 and 
to then use that device to replace the removed or failed disk 
dsk5 in disk group rootdg. 


Continue with operation? [y,n,q,?] (default: y) [Return 


LSM displays the following success screen: 


Replacement of disk dsk5 in group rootdg with disk device 
dsk10 completed successfully. 


Replace another disk? [y,n,q,?] (default: n) 


3. Press Return to return tothe main menu. 


C.2.7 Disabling a Disk 


This operation places the disk access record in an offline state. During 
searches for disk |Ds or members of a disk group, offline disks are ignored. 


To disable a disk: 


1. Select item 11 from the main menu. 
2. Select the disk you want to disable (in this case, dsk3): 


Use this menu operation to disable all access to a disk device 

by the Logical Storage Manager. This operation can be applied 

only to disks that are not currently in a disk group. Use this 
operation if you intend to remove a disk from a system without 

rebooting. 


NOTE: Many systems do not support disks that can be removed from 
a system during normal operation. On such systems, the 


offline operation is seldom useful. 


Select a disk device to disable [<address>,list,g,?] dsk3 
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LSM disables the disk and then prompts you to disable another device: 


Disable another device? [y,n,q,?] (default: n) 


3. Press Return to return tothe main menu. 


C.3 Disk Group Management 


This section describes how to manage disk groups with the voldiskadm 
menu interface. 


C.3.1 Importing a Disk Group 


If you want to move a disk group from one system to another, you must first 
disable (deport) it on the original system (Section C.3.2), then move the disks 
between systems and enable (import) the disk group on the target system. 


Note 


If two hosts sharea SCSI bus, make sure that the other host failed 
or deported the disk group. If two hosts import a disk group at the 
same time, the disk group will be corrupted and become unusable. 


To enable access by the system or cluster to a disk group, or to move a disk 
group from one system to another: 


1. Select item 8 from the main menu. 


2. Fromthe Enable access to (import) a disk group screen, select the name 
of the disk group to import: 


Use this operation to enable access to a disk group. This can be 
used as the final part of moving a disk group from one system to 
another. The first part of moving a disk group is to use the 
"Remove access to (deport) a disk group" operation on the 
original host. 


A disk group can be imported from another host that failed without 
first deporting the disk group. Be sure that all disks in the disk 
group are moved between hosts. 


If two hosts share a SCSI bus, be very careful to ensure that the 
other host really has failed or has deported the disk group. If 
two active hosts import a disk group at the same time, the disk 
group will be corrupted and will become unusable. 


Select disk group to import [<group>,list,g,?] (default: list) [Return 


GROUP: dgl (id: 921709259.1071.servername) 
DEVICES: 
dsk7 


GROUP: dgl (id: 922382892.1625.servername) 


DEVICES: 
dsk9 
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GROUP: dgl (id: 922908695.1779.servername) 
DEVICES: 

dské 

dsk8 


Select disk group to import [<group>,list,gq,?] (default: list) dgl 
When the import is complete, LSM displays the following success screen: 


The import of dgl was successful. 


Select another disk group? [y,n,q,?] (default: n) 


3. Press Return to return tothe main menu. 


C.3.2 Deporting a Disk Group 


Deport a disk group if you want to: 
« Movethedisks in a disk group to another system 
¢« Useall of the disks remaining in a disk group for some new purpose 


You cannot deport the rootdg disk group. 


Note 


For removable disk devices on some systems, it is important to 
disable all access to the disk before removing the disk. 


To deport a disk group: 


1. Select item 9 from the main menu. 


2. Fromthe Remove access to (deport) a disk group screen, enter the name 
of the disk group to deport: 


Use this menu operation to remove access to a disk group that 

is currently enabled (imported) by this system. Deport a disk 
group if you intend to move the disks in a disk group to another 
system. Also, deport a disk group if you want to use all of the 
disks remaining in a disk group for some new purpose. 


You will be prompted for the name of a disk group. You will 
also be asked if the disks should be disabled (offlined). For 
removable disk devices on some systems, it is important to 
disable all access to the disk before removing the disk. 


Enter name of disk group [<group>,list,q,?] (default: list) [Return 


GROUP DISK/VOLUME DEVICE/STATE LENGTH 
dg1 disk dgl01 dsks 4106368 
dg1 disk dskeé dské 4109440 


Enter name of disk group [<group>,list,q,?] (default: list) dgl 


The requested operation is to disable access to the removable 
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4. 


disk group named dgl. This disk group is stored on the 
following disks: 


dské on device dsk6é 
dg101 on device dsk8 


You can choose to disable access to (also known as "offline") 
these disks. This may be necessary to prevent errors if 
you actually remove any of the disks from the system. 


Disable (offline) the indicated disks? l[y,n,q,?] (default: n) [Return 


Continue with operation? [y,n,q,?] (default: y) 
Confirm the operation by pressing Return. 

When the disk group is deported, the following is displayed: 
Removal of disk group dgl was successful. 

Disable another disk group? [y,n,q,?] (default: n) 


Press Return to return to the main menu. 


C.4 Mirror Volume Management 


You can use the voldiskadm menu interface to add a mirror toa volume 
with no mirrors. You cannot use the voldiskadm menu interface to add 
mirrors to volumes that already have mirrors or that are comprised of more 
than one subdisk. 


To mirror volumes on a disk: 


1. 


Make sure that the target disk has an amount of space equal to or 
greater than the originating disk. 


Select item 6 from the main menu. 


In the Mirror volumes on a disk screen, enter the name of the disk 
whose volumes you want to mirror: 

This operation can be used to mirror volumes on a disk. The volumes 

can be mirrored onto another disk or onto any available disk space. 


Volumes will not be mirrored if they are already mirrored or contain 
more than one subdisk. 


Mirroring the root and swap volumes from the boot disk will produce a 
disk that can be used as an alternate boot disk. 


At the prompt below, supply the disk media name containing the 
volumes to be mirrored. 


Enter disk name [<disk>,list,q,?] dsk5 


Enter the target disk name. Volumes can be mirrored onto another disk 
or onto any available disk space. 
You can choose to mirror volumes from disk dsk5 onto any 


available disk space, or you can choose to mirror onto a specific 
disk. To mirror to a specific disk, select the name of that disk. 
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To mirror to any available disk space, select "any". 
Enter destination disk [<disk>,list,q,?] (default: any) dsk4 
LSM displays a verification screen. 

5. Press Return to make the mirror. 


The requested operation is to mirror all volumes on disk dsk5 
in disk group rootdg onto available disk space on disk dsk4. 


There is space already allocated on disk dsk4. If you don’t 
want to mirror onto this disk, enter "n" at the next prompt and 


restart this operation from the beginning. 


NOTE: This operation can take a long time to complete. 


Continue with operation? [y,n,q,?] (default: y) [Return 


LSM displays the status of the operation as it performs the mirroring: 
Mirroring of disk dsk5 is complete. 


When the mirroring operation is complete, LSM prompts you to mirror 
volumes on another disk. 


Mirror volumes on another disk? [y,n,q,?] (default: n) 


6. Press Return to return tothe main menu. 


C.5 Exiting the voldiskadm Menu Interface 
When you have completed all your disk administration activities, exit the 


voldiskadm menu interface by selecting menu option g from the main 
menu. 
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D 


The Visual Administrator 


The Visual Administrator, also called dx1sm, is the graphical user interface 
for the LSM software. This interface is designed primarily for disk and 
volume operations, but also provides a limited set of file system operations. 


This appendix provides an overview of Visual Administrator features and 
use. 


D.1 Starting the Visual Administrator 


To start the LSM Visual Administrator, you must be logged into an account 
that has root privileges. 


To start dxlsm, enter: 
# dxlsm 


The system displays the following message in a pop up window: 
dxlsm is coming up, please wait. 

When dxism starts, two LSM windows display: 

¢ Themain LSM Visual Administrator window 

¢ The View of rootdg window 


D.1.1 The Visual Administrator Main Window 
The Visual Administrator main window contains a menu bar and a set of 


buttons as shown in Figure D-1. If you have RAID subsystems installed, the 
main window displays an additional Subsystems button. 


Figure D-1: Visual Administrator Main Window 


[—/ Visual Administrator (host_name) | - |__| 
File Views Options Help 


Disks Volumes) World rootdg 


To display and manipulate different parts of the physical and logical storage 
systems, click on the View button. Each view window title includes the name 
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D.1.1.1 


D.1.1.2 


of the machine on which the session is running. The main window contains 
a button for every view on the system. 


The Visual Administrator has two types of views: default and user-created. 
You cannot remove or rename default views. 


Default Views 


From the main window, click on the following view buttons to access the 
default view window: 


Table D-1: Accessing the Default View Window 


View Buttons Window Access 

Disks View of disks Displays all physical disks on 
the system 

Volumes View of volumes Displays all volumes, plexes, and 


associated subdisks on the system 


World View of world Displays everything on the system 
including physical and LSM disks, 
volumes, and other objects 


rootdg View of rootdg Displays everything in the default 
disk group, rootdg, including LSM 
disks, volumes, and other objects 


User-Created Views 


A user-created view is a view window defined to focus on a part of a system. 
For example, you can create a view window for each disk group. Create a 
new view window with the Views menu on the main window. Creating this 
window will place a new button on the window. Once the view is created, you 
can add icons by selecting an icon from another view and either using the 
Icon menu Create Icons option or dragging and dropping the selected icon. 


User-created views thus contain copies of icons from default views. 
Operations performed on these icon copies are reflected in the default views 
that display the affected icons. However, icons that appear in user-created 
views are not always updated when the icons are altered in the default view. 


D.1.2 The View of rootdg Window 


Immediately after the main window appears, the View of rootdg window 
appears. This view displays icons representing everything that is in the 
rootdg disk group. Whenever possible, perform operations in the View of 
rootdg window or in another disk group view. 


Figure D-2 shows a View of rootdg window that contains two volumes. 
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Figure D-2: View of rootdg Window 
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D.2 Mouse Buttons 


A two- or three-button mouse is required to use the Visual Administrator. 
Table D-2 describes the mouse buttons. Unless otherwise stated, all 
directions to select or click on an item refer to the left mouse button (MB1). 
Right-click refers to the right mouse button for both two- and three- button 
mice. 


Table D—2: Default Mouse Buttons 


Virtual Mouse 3-Button 2-Button Function 

Button Access Access 

MB1 Left Left Selects a single icon. 

MB2 Middle Ctrl-Left Selects either one or multiple 


icons simultaneously. 


MB3 Right Right Displays either the properties form 
or the analysis statistics form for 
that object, depending on whether 
the icon is undergoing analysis. 


Shift-MB1 Shift-L eft Shift-Left | Toggles between minimizing and 
maximizing an icon. 

Shift-MB2 Shift-Middle Ctrl-Right Toggles between starting and 
stopping projection on the 
selected icon. 

Shift-MB3 Shift-Right Shift- Right Displays the properties form for 


the object, regardless of whether 
analysis is in effect. 


An icon can be deselected by positioning the pointer over that icon and 
clicking MB2. This works regardless of which mouse button was used to 
select the icon. 
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Note 


The examples in this document assume that you are using a 
three-button mouse, set up according to Table D-2. It is possible 
to redefine mouse buttons (using the xmodmap command, for 
example). See your X Window System documentation for details. 


D.3 Icons for LSM Objects 


The Visual Administrator interface uses icons to represent LSM objects 
(volumes, plexes, subdisks, and disks.) 


Disk groups are represented as view windows rather than icons. Theicons 
representing LSM disks, volumes, and other objects belonging toa particular 
disk group are all displayed within the view of the disk group. 


Note 


Icons representing all elements of the system are displayed in the 
View of World window accessed with the World button on the 
Visual Administrator window. 


D.3.1 Icon Characteristics 


Figure D-3 shows how the Visual Administrator represents LSM objects. 
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Figure D-3: Icons That Represent LSM Objects 
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With some operations, icons are updated almost instantly to reflect the 
results of the operation just performed. During other operations, it might 
take time for a particular icon to update itself. While being updated, icons 
are prevented from accepting input or undergoing configuration changes. 
Inaccessible icons are grayed out. 


D.3.2 Manipulating Icons 


There are two ways to manipulate icons: 


¢ Select-Operate. With this option you select an icon representing an LSM 
object (click on the icon or click MB2 on multiple icons) and perform the 
desired operation on that object by selecting from window menus. 


¢ Drag and Drop. With this option you drag the icon of the selected object 
(hold down MB1 and move the mouse until the outline of the icon reaches 
the desired location) and drop it (release the mouse) elsewhere, such as 
on another object in a view window. 


When dropping an icon onto another icon, the dragged icon must be 
positioned so that the pointer (in the image of a hand) is directly over an 
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unobscured portion of the icon on which it is to be dropped. Table D-3 


describes drag and drop operations: 


Table D-3: Drag and Drop Operations 


Icon Type Drop Location Action 

Free subdisk View window Creates a plex and associates the 
subdisk with the plex. 

Free subdisk LSM disk Creates an identical subdisk on thedisk. 

Free subdisk Plex Associates the subdisk with the plex. 

Associated subdisk Free subdisk Swaps the associated subdisk with the 
free subdisk. The free subdisk becomes 
associated and replaces the original 
subdisk, which is removed. 

Associated subdisk LSM disk Creates an identical free subdisk 


Associated subdisk 


Associated plex 


View window 


View window 


on the LSM disk, then swaps the 
associated subdisk with the new free 
subdisk. The free subdisk becomes 
associated and replaces the original 
subdisk, which is removed. 


Dissociates the subdisk. 


Dissociates the plex. 


Dissociated plex _User’s view Copies the plex icon to the user’s view. 
window 

Plex Volume Associates the plex to the volume. 

Disk User's view Copies the physical or LSM disk 
window icon to the user’s view. 

Volume User’s view Copies the volume icon to the 
window user’s view. 

LSM disk Disk group view Adds an LSM disk (corresponding 


to the slice, simple, or nopriv disk) 
to that disk group. 


D.4 Pull-Down Menus 


The Visual Administrator provides pull-down menus that provide access to 
various Visual Administrator features. 


Menus are located in the menu bar just below the window's title. 
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D.5 Forms 


The Visual Administrator uses forms to present textual information. 
These forms also provide useful information about existing objects and 
configurations. 


There are two types of forms: 


¢« General forms usually appear during menu-selected operations or setup 
requests and accept or require user input. 


¢ Properties forms display detailed information about a specific object’s 
characteristics, some of which can be modified directly. Access properties 
forms by clicking MB3 on the chosen icon. (If the icon is undergoing 
analysis, use Shift-MB3). 


D.5.1 Fields 


Many forms require information in order to proceed with an operation. If 
a required field in the form is either left blank or is incorrect, an error will 
result. Other fields already contain information (Such as default values), 
which you can either alter or accept. Yet other fields are read-only; these 
fields beep if you attempt to change them. 


D.5.2 Form Error Messages 


Error messages are displayed if you select Apply with incorrect fields on 

a form. A message is printed at the bottom of the form just above the 
buttons, and you can correct the values for those fields. If the error cannot 
be corrected or the operation is no longer desired, select Cancel. 


D.6 Error and Warning Messages 


The Visual Administrator uses dialog boxes to present error or warning 
messages. When a message is displayed, you cannot proceed until you select 
one of the buttons displayed in the error dialog box. Some warning boxes 
announce that a prerequisite is not met and require you to acknowledge this 
by clicking the Continue button before reattempting the operation. 


D.7 Help Windows 


You can access online help text from the menu bar of the main window and 
from the view windows. Help text is also available through the Help option 
in submenus or through the Help button at the bottom of forms. The Help 
window contains information about the current window, menu, form, or 
operation. 
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At the bottom of each Help window is a SEE ALSO area that lists related 
Help topics. To access any of the listed Help topics, click on the appropriate 
words in the SEE ALSO list. The Help facility keeps track of the order in 
which Help topics are visited, So you can move between topics by selecting 
Previous or Next from the menu bar. 


The Help menu in the menu bar of the Help window itself provides access to 
the following information: 


Table D—4: Help Menu Options 


General Help _— Accesses Help text that includes general information on the 
Visual Administrator Help facility and how it is used. 


Help Index Access a complete listing of the available Help topics arranged 
in logical groupings. Once you select a topic from this list, you 
can access that topic directly from the SEE ALSO section of 
this Help window, which lists all topics alphabetically. 


To dose the Help window, select the Close option from the File menu. The 
record of help topics visited is retained. 


D-8 The Visual Administrator 


E 


Using the Visual Administrator 


This appendix shows you how to complete common LSM management tasks 
using the Visual Administrator. 


E.1 Managing Volumes 


The following sections provide information on menus and forms relating to 
volume management. 


E.1.1 Volume Menus 


E.1.1.1 


Both the Basic-Ops and Advanced-Ops menus provide access to 
volume-related menus. Most menus provide a Help selection, which contains 
information about the items and operations listed in that particular menu. 


Basic-Ops Menu 


You access the BasicOps menu by selecting: 
Basic-Ops — Volume Operations 


This menu provides access to volume operations involving general volume 
maintenance. These operations use the automated approach to volume 
management. 


The Volume Operations menu provides the following selections: 
* Create 

« Remove Volumes Recursively 

e Add Plex 

« Remove Plex 


e« Resize 
¢ Snapshot 
« Help 


The following list describes these menu selections: 
e« Create 


Basic-Ops — Volume Operations —> Create 
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This operation creates a simple or striped volume on one or more disks. 
You can select oneor more disks on which to create the volume (providing 
that there is sufficient space on the disks). If no disks are specified, 

the LSM software automatically determines the disks to use based on 
available free space. 


From the Create menu, you Select the type of volume to be created froma 
submenu listing two of the basic types of volumes: 


Table E—1: Create Volume Menu 
Type Description 


Simple Creates a simple, concatenated volume whose subdisks are 
arranged sequentially and contiguously within a plex. 


Striped Creates a volume with data spread fairly evenly across 
multiple disks by way of striping. Stripes are relatively 
small, equally-sized fragments that are allocated alternately 
to the subdisks within a plex. 


RAID 5 Creates a volume with data and parity spread evenly and 
alternately across subdisks within a plex. 


To create a mirrored volume, create a simple or striped volume, then 
mirror it using the Add Mirror option. 


Requirements: 
- Only disks in the same disk group can be selected. 


- Only LSM disks (disks under LSM control and assigned to a disk 
group) can be selected. 


- If striping is to bein effect, at least two disks are required in order 
for the operation to succeed. 


Forms: Simple Volume/F S Create F orm and Striped Volume/F S Create 
Form. 


e« Remove Volumes Recursively 


Basic-Ops — Volume Operations — Remove Volumes Recursively 


This operation removes the selected volumes and deallocates all of 
the disk space set aside for that volume. It automatically removes all 
underlying plexes and subdisks associated with the volume. 


Note 


This is a permanent operation and cannot be undone. If 
completed, it will be difficult or impossible to retrieve the data 
associated with that volume. For this reason, a confirmation 
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window is presented if the selected volume is not ready for 
removal (that is, started or enabled). 


Requirements: 

- Atleast one volumeicon must be selected. 

- Theselected volumes cannot contain a mounted file system. 
Add Plex 


Basic-Ops — Volume Operations > Add Mirror 


This operation adds a plex to the selected volume by associating a plex 
of the correct length to the volume. The plex effectively duplicates the 
information contained in the volume. Although a volume can have a 
single plex, at least two are required for mirroring. 


From the Add Mirror menu, you select the type of plex to be added from 
a submenu listing two of the basic types of plexes: 


Table E-2: Add Mirror Menu Options 
Type Description 


Simple Adds a simple, concatenated plex whose subdisks are 
arranged sequentially and contiguously. 


Striped Adds a plex whose data is striped (allocated evenly and 
alternately across each of its subdisks). 


You can select disks for this operation. However, the number of selected 
disks must be sufficient to accommodate the layout type of both the 
existing volume and the plex to be added. If no disks are selected, the 
free space for the plex is allocated by the LSM software. 


Requirements: 
- A volume icon must be selected. 


- Fora striped plex, at least two disks other than those already in use 
by the volume must be available. 


Remove Plex 
Basic-Ops — Volume Operations — Remove Mirror 


This operation removes the selected plex, along with any associated 
subdisks. 


Requirements: 

- A plex icon must be selected. 

- Thelast valid plex in a started or enabled volume cannot be removed. 
Resize 
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Basic-Ops — Volume Operations — Resize 


This operation resizes the selected volume. The volume can be increased 
to, increased by, reduced to, or reduced by a given length. This involves 
adding or removing disk space to or from the plexes associated with 

the volume. 


If new disk space is needed during the resize, it is allocated as necessary; 
if space becomes unused, it is added to the free space pool. 


Requirements: 
- A volume icon must be selected. 
- A volume containing a mounted file system cannot be reduced. 
Form: Volume Resize Form 
¢« Snapshot 


Basic-Ops — Volume Operations — Snapshot 


This operation backs up a volume by creating a snapshot image of that 
volume. This is a convenient way of performing backup with minimal 
interruption. 


This operation creates a new volume that is a snapshot of an existing 
volume. This is done by creating a plex of the existing volume (creating 
and associating a plex) using disk space from the pool of free disk 
space. The plex is brought up to date (this might take some time) and a 
separate (Snapshot) volume is then created for that plex. The snapshot 
volume represents a consistent copy of the original volume at the time 
the snapshot was begun. The snapshot volume can be used to make a 
backup of the original volume without stopping it. After the backup is 
made, you can remove the snapshot volume without losing any data. 


Note 


For UFS volumes, it is recommended that you unmount the 
file system briefly to ensure the snapshot data on disk is 
consistent and complete. 


From the Snapshot menu, a submenu allows you to first create the 
snapshot plex and then the snapshot volume: 
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Option Description 


Snapstart Start the snapshot procedure by creating a snapshot plex 
within the volume to be backed up. It takes a variable 
amount of time to update the new plex, during which 
time the snapshot plex icon is grayed out. 


Snapshot At a convenient time (preferably after warning users 
to suspend activity briefly), create another volume for 
the snapshot plex. This portion of the procedure should 
take only seconds to complete. 


Requirements: 
- A volume icon must be selected. 


- Theremust be sufficient free disk space to accommodate the snapshot 
volume. 


Form: Snapshot Form 


E.1.1.2 Advanced-Ops Menu 


You access the Advanced-Ops menu selections by selecting: 


Advanced-Ops — Volume 


This menu provides access to assorted volume operations. These volume 
operations use the manual approach to volume management. The Volume 
menu provides the following selections: 


Create 

Remove Volumes 
Initialize Volumes 
Start Volumes 

Stop Volumes 
Resynchronize Volumes 
Set to Maint State 
Recover Volumes 

Help 


The following list describes these menu selections: 


Create 


Advanced-Ops — Volume —> Create 


This operation creates a volume. You can select one or more plexes to be 
associated with the new volume after creation. 


Form: Volume Create Form 
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« Remove Volumes 


Advanced-Ops — Volume — Remove Volumes 


This operation removes the selected volumes. If the selected volume is 
started, it must be stopped before it can be removed. 


Note 


This is a permanent operation and cannot be undone. Any 
plexes associated with the volume will be dissociated and 
left behind. 


Requirements: 

- Atleast one volumeicon must be selected. 

- Thevolume must be stopped before it can be removed. 
e Initialize Volumes 


Advanced-Ops — Volume = Initialize Volumes 
This operation initializes the selected volumes. 


From the Initialize volumes menu, you select the type of initialization 
from a submenu listing the following choices: 


Option Description 


Active This enables the selected volume and its associated plexes, and 
sets the state of all associated plexes to ACTIVE. 


Enable This enables the selected volume and its associated plexes, 
but leave the plex states as EMPTY. 


Clean This sets the state for all associated plexes of the selected volume 
to CLEAN. This can be applied only under limited circumstances. 


Zero This enables the selected volume and its associated plexes, 
then write zeroes over the entire volume. After the 
operation completes, all associated plexes are set to ACTIVE, 
assuming that there are no I/O errors. 


Requirements: 
- Atleast one volumeicon must be selected. 
- Theselected volume cannot have been previously initialized. 


- Theselected volume should have at least one associated plex that is 
complete (or contiguous). 


¢ Start Volumes 


Advanced-Ops —> Volume —> Start Volumes 
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This operation starts the selected volumes. A volume must be started 
before it can be accessed. 


From the Start volumes menu, a submenu allows you toindicate whether 
all volumes or just those selected should be started: 


Option Description 
Start Start the selected volume, which must be startable. 
Start All Start all volumes in this disk group that can be started. 


Requirements: 


- Atleast one volume icon must be selected for the Start operation. No 
volume icons need to be selected for the Start All operation. 


- A volume should be initialized before it can be started. 
Stop Volumes 


Advanced-Ops — Volume —> Stop Volumes 


This operation stops the selected volumes. A volume that is stopped 
is inaccessible. 


From the Stop volumes menu, a submenu allows you to indicate whether 
all volumes or just those selected should be stopped: 


Option Description 
Stop Stop the selected volume. 


Stop All Stop all volumes in this disk group. 


Requirements: 


- Atleast one volume icon must be selected for the Stop operation. No 
volume icons need to be selected for the Stop All operation. 


- A volume must be started before it can be stopped. 


- A volume that is in use or contains a mounted file system cannot 
be stopped. 


Resynchronize Volumes 


Advanced-Ops — Volume —> Resynchronize Volumes 


This operation brings all plexes within the selected volumes up to date. 
Any plexes that are inconsistent are resynchronized to contain consistent 
data. 


This operation might take some time depending on how large the plexes 
are and whether or not logging is enabled. 


Requirements: 
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- Atleast one volumeicon must be selected. 
- Theselected volumes must be started. 
¢ Set to Maintenance State 


Advanced-Ops — Volume — Set to Maint State 


This operation sets the state of the selected volumes to a maintenance 
state. Refer to the volume(8) reference page for information on the 
maintenance state. 


Requirement: At least one volume icon must be selected. 
e Recover Volumes 


Advanced-Ops — Volume —> Recover Volumes 


This operation recovers the selected volumes. At least one volume icon 
must be selected. 


E.1.2 Volume Forms 


Some volume operations result in the appearance of forms, which must be 
completed in order for that operation to proceed. Most forms provide a Help 
button, which contains information relevant to the fields and other aspects 
of that particular form. 


E.1.2.1  Basic-Ops Forms 


The following forms are accessed via volume-related selections from the 
Basic-Ops menu: 


¢« Simple Volume/FS Create Form 


Basic-Ops — Volume Operations — Create — Simple 


This form creates a concatenated volume and optionally creates a file 
system on the new volume. The form is divided into two sections, one for 
volume creation and the other for file system creation. Most of the form 
fields are already set to the defaults for the creation of a new volume; 
the file system fields are grayed out because the default is not to add a 
file system to the volume. The following tables describes the fields for 
this form. 


Most fields in this form are required; those that are optional are listed 
here. All fields in this form are read/write fields. 
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Field Description 


Volume The name of the volume to be created. The name must 
name: be unique within this disk group. The maximum length 
of this field is 31 characters. 
Volume The desired volume size. The size should be entered as a number 
size: followed immediately by the letter k, m, or s to indicate kilobytes, 


megabytes, or sectors, respectively. If no unit is specified, the 
default is sectors. The volume size should be less than or 
equal to the available free space of the disks. 


Usage The desired usage type. The fsgen type is the file system 

Type: generic usage type, which assumes that the volume is being 
used by a file system. The gen type is the generic usage 
type, which makes no assumptions regarding the data content 
of the volume. The default is fsgen. 


Create file Indicates whether a file system is to be created. When you 

system: invoke this form from the Volume Operations menu, the default 
is not to create a file system (No). All fields below this field 
are accessible only when Yes is specified here. 


The following fields apply only if the Create file system: field is set to 
Yes. Otherwise, these fields are inaccessible. 


Field Description 

FS type: UFS is the only currently supported files system type. 
Mount file Indicates whether the file system should be mounted after 
system: creation. If the answer is Yes (the default), a mount point 


must also be specified in the next field. All fields below this 
field are accessible only when Yes is specified here. 


Mount point: The desired mount point for the new file system. If the 
specified mount point does not already exist, the Visual 
Administrator automatically creates it. This field is 
required if the file system is to be mounted. 


Mount Indicates whether this file system should be mounted 
automatically: every time the system comes up (by placing an entry 
in /etc/fstab). The default is Yes. 


Striped Volume/F S Create Form 


Basic-Ops — Volume Operations —> Create — Siriped 


This form creates a concatenated volume and optionally creates a file 
system on the new volume. The form is divided into two sections, one 
for volume creation and the other for file system creation. Most of the 
form fields are already set to the defaults for the creation of a new 
volume; the file system fields are grayed out because the default is not 
to add a file system to the volume. The following table describes the 
fields for this form. 
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Most fields in this form are required; those that are optional are listed 
here. All fields in this form are read/write fields. 


Field Description 
Volume The name of the volume to be created. The name must 
name: be unique within this disk group. The maximum length 


of this field is 31 characters. 


Volumesize: The desired volume size. The size should be entered as a 
number followed immediately by the letter k, m, or s to indicate 
kilobytes, megabytes, or sectors, respectively. If no unit is 
specified, the default is sectors. If the size is not wholly divisible 
by the stripe width, LSM will adjust the volume size up to 
the next even multiple in order to create the volume. For a 
striped volume, the volume size should be calculated as follows: 
vol_size = stripe width * number of_stripes * n, wheren is a 
number greater than zero. The volume size should be less than 
or equal to the available free space of the disks. 


Usage Type: The desired usage type. The fsgen type is the file system 
generic usage type, which assumes that the volume is being 
used by a file system. The gen type is the generic usage 
type, which makes no assumptions regarding the data content 
of the volume. The default is fsgen. 


Number of Thenumber of stripes that the volume's plex is to have. This 

Stripes: is effectively the number of disks on which the volume is to be 
created. If some number of disks have already been selected, that 
number of stripes appears in this field. This number corresponds to 
the number of disks across which data will be striped. I f no number 
is specified, LSM selects an appropriate number (usually 2). 


Stripe The width of the stripes on the plex that this volume will 

width: have. The value specified might be optimized for the particular 
application. However, the default value for this field of 128 
sectors is a good stripe width for most systems. 


Create file Indicates whether a file system is to be created. When you 

system: invoke this form from the Volume Operations menu, the default 
is not to create a file system (No). All fields below this field 
are accessible only when Yes is specified here. 


The following fields apply only if you set the Create file system: field to 
Yes. Otherwise, these fields are inaccessible. 


Field Description 


FS type: UFS is the only currently supported file system type. 


Mount filesystem: Indicates whether the file system should be mounted after 
creation. If the answer is Yes (the default), you must also 
specify a mount point in the next field. All fields below this 
field are accessible only when Yes is specified here. 
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Field 


Description 


Mount point: 


Mount 
automatically: 


The desired mount point for the new file system. If the 
specified mount point does not already exist, the Visual 
Administrator automatically creates it. This field is 
required if the file system is to be mounted. 


Indicates whether this file system should be mounted 
every time the system comes up (by placing an entry 
in /etc/fstab). The default is Yes. 


Volume Resize Form 


Warning 


File systems and other applications cannot currently resize 
their data when LSM resizes a volume, therefore shrinking a 
volume that contains data destroys the data. Therefore, use 
this operation only when a volume contains no valuable data. 


Basic-Ops — Volume Operations — Resize 


This form either grows or shrinks a volume using the Logical Storage 
Manager free space management resources. If new disk space is needed, 
it will be allocated as necessary; if space becomes unused, it will be 
added to the free space pool. The following table describes the fields 


in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless they are listed 


as read-only. 
Field Description 
Selected Volume: This field displays the name of the volume to be resized. 


Current size: 


Option: 


Size/Amount: 


This field is read-only and cannot be changed. 


This field displays the current size of the volume to be 
resized. This field is read-only and cannot be changed. 


The type of resize operation to be performed. This 
will determine whether the volume is grown or shrunk 
to a certain size, or grown or shrunk by a given 
amount. The default is Grow To. 


Enter either the length to which or the amount by which the 
volume is to be resized. If Grow To or Shrink To is selected, 
this field should reflect the final size. If Grow By or Shrink 
By is selected, this field should reflect the amount by which 
the size should change. The new volume size should be less 
than or equal to the available free space of the disks. 


Snapshot Form 
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Basic-Ops — Volume Operations — Snapshot 


This form creates a snapshot of the selected volume for backup purposes. 
The following table describes the fields for this form. Fields in this form 
are required. 


Fields in this form are read/write fields, unless they are listed as 
read-only. 


Field Description 


Selected The name of the volume to be used as the snapshot source. 
Volume: This field is read-only and cannot be changed. 


Snapshot The name of the snapshot volume to be created as a backup. 

name: Although a default name appears in this field, a name that 
more closely resembles that of the selected volume should 
be used for easier association. The maximum length is 31 
characters. The snapshot name must be unique. 


Requirement: There must be sufficient free space to accommodate the 
snapshot volume. 


E.1.2.2 Advanced-Ops Forms 
The following forms are accessed via volume-related selections from the 
Advanced-Ops menu: 
« Volume Create Form 


Advanced-Ops —> Volume —> Create 


This form creates a volume according to the user’s specifications. The 
following table describes the fields for this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 
Volume The name of the volume to be created. The name must be 
name: unique within this disk group. The maximum length of this 


field is 31 characters. The name specified for the volume 
must be unique within this disk group. 


Usage Type: The desired usage type The fsgen type is the file system 
generic usage type, which assumes that the volume is being 
used by a file system. The gen type is the generic usage type, 
which makes no assumptions regarding the data content of the 
volume. The default is £sgen. This field is optional. 


User: The name of the user who will be the owner of this volume. 
This must be a valid user name on the system. The maximum 
length of this field is 64 characters. 
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Field 


Description 


Group: 


Mode: 


Length: 


Plexes: 


Read Policy: 


Preferred 
Plex: 


Comment: 


Startup: 


Logging: 


Writeback: 


PutilO: 


The name of the group that will own this volume. This 
must be a valid group name on the system. The maximum 
length of this field is 64 characters. 


The permissions mode for the new volume. Only numbers 
of the correct format are valid in this fidd. The maximum 
length of this field is four characters. 


The length of the volume. If no unit is specified, the 
default is sectors. Only positive numbers greater than 
zero are valid. This field is optional. 


This field displays the number of plexes associated with the 
volume. I f no plexes were selected prior toinvoking this form, this 
field displays 0. This field is read-only and cannot be changed. 


The read policy that the volume adopts when deciding which 
plex to write to. These policies are distinguished as follows: 


- Round Robin—All plexes are read equally, in turn. 


- Preferred Plex—A particular plex is specified as the plex to 
be read whenever possible. The preferred plex will not be 
read in situations such as when that plex is detached due 
to I/O failure. 


- Based on plex layouts—All plexes are read equally and in 
turn, unless a striped plex is present, in which case the 
striped plex becomes the preferred plex. This option is the 
default and it typically gives the best read performance. 


The name of the preferred plex if the Preferred Plex read policy 
has been specified. The string in this field must be the name of 
a valid plex that is associated with this volume. This field is 
required if Preferred Plex is specified in the Read Policy: field. 


An appropriate comment for this volume. The maximum length 
of the comment is 40 characters. This field is optional. 


This field might contain an arbitrary string that is reserved for 
the user by usage-type utilities. The intention is that this field 
be used to store options that apply to the volume, such as for the 
start volumes operation. This is normally a comma-separated 
list of flag names and option=value pairs. This field is optional. 


Indicates whether logging is defined and supported on this 
volume. An undefined log type is included to support old versions 
of the Logical Storage Manager. The default is Don’t Log. 


Indicates whether the volume is to write back on read failure. 
If set to Yes, an attempt will be made to fix a read error 
from a participating plex. The default is Yes. 


Permanent utility field 0. This is reserved for Logical Storage 
Manager use, but can be changed. The maximum length of all 
Putil fields is 14 characters. This field is optional. 
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Field 


Description 


Putil1: 


Putil2: 


Permanent utility field 1. This field is reserved, but can 
be changed. This field is optional. 


Permanent utility field 2. This field is reserved, but can 
be changed. This field is optional. 


E.1.3 Volume Properties Form 


The following is the properties form that reveals the properties of a 


particular volume: 


Volume Properties Form 


You can access this form by clicking the MB3 on the desired volume icon. 
(If the volume icon is undergoing analysis, press Shift-MB3 instead.) 


This form provides detailed information on the attributes of a particular 
volume. The following table describes the fields in this form. 


The fields in this form are read/write fields, unless listed as read-only. 
Properties of the volume can be changed via this form by altering the 
current values in the appropriate read/write fields and then clicking 
on the Apply button. 


Field 


Description 


Volume name: 


Usage Type: 


Utility State: 


User: 


Group: 


Mode: 


The name of the volume. This name must be unique 
within this disk group. The maximum length of this 
field is 31 characters. This volume name can be changed 
by entering another name in this field. 


The volume usage type. The fsgen type is the file 
system generic usage type, which assumes that the 
volume is being used by a file system. The gen typeis 
the generic usage type, which makes no assumptions 
regarding the data content of the volume. 


The state that the volume is currently in. This should 
be either Started, Startable, or Unstartable. This field 
is read-only and cannot be changed. 


The name of the user who owns this volume. This 
must be a valid user name. The maximum length 
of this field is 64 characters. 


The name of the group that will own this volume. 
This must be a valid group name. The maximum 
length of this field is 64 characters. 


The permissions mode for the volume. Only numbers of 
the correct format are valid in this fidd. The maximum 
length of this field is four characters. 
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Field 


Description 


Length: 


Plexes: 


Read Policy: 


Preferred Plex: 


Comment: 


Startup: 


Logging: 


Writeback: 


PutilO: 


Putil1: 


Putil2: 


The length of the volume. If no unit is specified, the default is 
sectors. Only positive numbers greater than zero are valid. 


This field displays the number of plexes associated 
with the volume. If no plexes were selected prior to 
invoking this form, this field displays 0. This field is 
read-only and cannot be changed. 


The read policy that the volume adopts when deciding which 
plex to write to. These policies are distinguished as follows: 


- Round Robin—All plexes are read equally, in turn. 


- Preferred Plex—A particular plex is specified as the plex 
to be read whenever possible. The preferred plex will not 
be read in situations such as when that plex is detached 
due to I/O failure. 


- Based on plex layouts—All plexes are read equally and in 
turn, unless a striped plex is present, in which case the 
striped plex becomes the preferred plex. This option is the 
default and it typically gives the best read performance. 


The name of the preferred plex if the Preferred Plex 
read policy has been specified. The string in this field 
must be the name of a valid plex that is associated with 
this volume. This field applies only if Preferred Plex 

is specified in the Read Policy: field. 


A comment relevant to this volume. The maximum 
length of the comment is 40 characters. 


This field might contain an arbitrary string that is reserved 
for the user by usage-type utilities. The intention is that 
this field be used to store options that apply to the volume, 
such as for the start volumes operation. This is normally a 
comma-separated list of flag names and option=value pairs. 


Indicates whether logging is defined and supported on this 
volume. An undefined log type is included to support old 
versions of the Logical Storage Manager. 


Indicates whether the volume is to write back on read 
failure. If set to Yes, an attempt will be made to fix a 
read error from a participating plex. 


Permanent utility field 0. This is reserved for Logical 
Storage Manager use, but can be changed. The maximum 
length of all Putil fields is 14 characters. 


Permanent utility field 1. This field is reserved, 
but can be changed. 


Permanent utility field 2. This field is reserved, 
but can be changed. 
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Field Description 


TutilO: Temporary utility fied 0. This is reserved for LSM 
use, but can be changed. The maximum length of 
all Tutil fields is 14 characters. 


Tutil1: Temporary utility fidd 1. This field is reserved, 
but can be changed. 
Tutil2: Temporary utility fidd 2. This field is reserved, 


but can be changed. 


Kernel State: | Thekernel stateof this volume. These states are distinguished 
as follows: 


- Enabled — The volume device can be used. This is the 
default state. 


- Detached — The volume device cannot be used, but ioctls 
will still be accepted. 


- Disabled — The volume cannot be used for any operations. 


Number of 1|O The number of failed 1/O operations on this volume since 
Failures: the last boot. This field cannot be changed. 


E.2 Plex Management 


The following sections provide information on menus and forms relating 
to plex management. 


E.2.1 Plex Menus 


Advanced-Ops —> Plex 


The Advanced-Ops menu provides access tothe following plex-related menus: 


Create 

Remove Plexes 
Associate Plexes 
Dissociate Plexes 
Attach Plexes 
Detach Plexes 
Help 


The Help selection accesses a Help window that displays information 
relevant to the plex operations. 


The plex Advanced-Ops menus are described in the following list: 


Create 
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Advanced-Ops — Plex —> Create 


This operation creates a plex. You can select one or more subdisks to be 
associated with the new plex after creation. 


Form: Plex Create Form 
Remove Plexes 


Advanced-Ops — Plex — Remove plexes 


This operation removes the selected plexes. This is a permanent 
operation and cannot be undone. Any subdisks associated with the plex 
will be dissociated and left behind. 


Requirements: 
- At least one plex icon must be selected. 


- Ifthe selected plex is associated with a volume, it must be dissociated 
before it can be removed. 


Associate Plexes 


Advanced-Ops — Plex — Associate Plexes 


This operation associates one or more selected plexes with the selected 
volume. If the volume is started, LSM begins to bring the plex up to date 
by copying all necessary data to the plex. This might take time. 


Requirements: 

- A volumeicon and at least one plex icon must be selected. 
- Only nonassociated plexes can be associated. 

Dissociate Plexes 


Advanced-Ops — Plex — Dissociate Plexes 


This operation dissociates one or more selected plexes from their parent 
volumes. This operation will fail if the plex cannot be dissociated. For 
example, the last plex in a started volume cannot be dissociated. 


Requirements: 
- At least one plex icon must be selected. 
- Only associated plexes can be dissociated. 


- Before the last plex in a volume can be dissociated, that volume must 
be stopped. 


Attach Plexes 
Advanced-Ops —> Plex — Attach Plexes 


This operation attaches one or more selected plexes to their parent 
volumes. A plex must be detached but still associated with an enabled 
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volume in order to be attached; the plex is actually being reattached 
with its parent volume. 


Requirements: 

- Atleast one plex icon must be selected. 

- A plex must be detached before it can be attached. 

- Only a plex associated with an enabled volume can be attached. 
e Detach Plexes 


Advanced-Ops —> Plex — Detach Plexes 


This operation detaches one or more selected plexes from their parent 
volumes. A detached plex is inaccessible for reads and writes, but is 
still associated with the volume. 


Requirements: 
- Atleast one plex icon must be selected. 
- Only associated plexes can be detached. 


- This operation is not permitted when the specified plex is the last 
valid plex on the volume. 


E.2.2 Plex Forms 


Some plex operations result in the appearance of forms, which must be 
completed in order for that operation to proceed. Most forms provide a Help 
button, which contains information relevant to the fields and other aspects 
of that particular form. 


The following forms are accessed via plex-related selections from the 
Advanced-Ops menu: 


¢ Plex Create Form 


Advanced-Ops —> Plex —> Create 


The following table describes the fields in this form. Most fields in this 
form are required; those that are optional are listed here. Fields in this 
form are read/write fields, unless listed as read-only. 


Field Description 


Plex name The name of the plex to be created. The name must be 
unique within this disk group. The maximum length 
of this field is 31 characters. 


Plex state The plex utility state This is reserved for use by usage 
types. This field is optional. 
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Field 


Description 


Volume 


Layout 


Stripe width 


Subdisks 


Comment 


Errors 


PutilO 


Putill 


Putil2 


The name of the volume that this plex should be associated 
with. The name must be a valid volume name in this 
disk group. The maximum length of this field is 31 
characters. This field is optional. 


The desired layout for the plex. A concatenated plex is a 
plex with associated subdisks that are both sequentially 
and contiguously arranged. A striped plex is a plex 
that distributes data evenly across each of its associated 
subdisks. The default is Concatenated. 


The width of the stripes on the plex. The stripe width must be 
a number greater than 0. If no units are specified, sectors are 
assumed. The maximum length of this field is 14 characters. If 
a striped plex layout is specified, this field is required. This field 
must be blank if a concatenated plex layout is specified. 


The number of subdisks associated with the plex. This 
field is read-only and cannot be changed. 


An appropriate comment for the plex. The maximum length 
of the comment is 40 characters. This field is optional. 


Indicates whether the plex should participate in LSM 
error policies. The default is Participate. 


Permanent utility field 0. This is reserved for LSM use, 
but may be changed. The maximum length of all Putil 
fields is 14 characters. This field is optional. 


Permanent utility field 1. This field is reserved, but can 
be changed. This field is optional. 


Permanent utility field 2. This field is reserved, but can 
be changed. This field is optional. 


E.2.3 Plex Properties Forms 


The following list describes the properties form that reveals the properties 
of a particular plex: 


Plex Properties Form 


To access the plex properties form, click the MB3 mouse button on 
desired plex icon. 


This form provides detailed information on the attributes of a particular 
plex. The following table describes the fields in this form. 


The fields in this form are read/write fields, unless listed as read-only. 
Properties of the plex can be changed via this form by altering the 
current values in the appropriate read/write fields and then clicking 
on the Apply button. 
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Field 


Description 


Plex name 


Plex state 


Volume 


Layout 


Stripe width 


Subdisks 


Log Subdisk 


Comment 


Errors 


PutilO 


Putill 


Putil2 


TutilO 


Tutill 


Tutil2 


The name of the plex. The name must be unique 
within this disk group. The maximum length of this 
field is 31 characters. The plex name can be changed 
by entering another name in this field. 


The plex utility state. This is reserved for use by usage 
types. This field is read-only and cannot be changed. 


The name of the volume that this plex should be associated 
with. This field is read-only and cannot be changed. 


The layout of the plex: concatenated or striped. A 
concatenated plex is a plex with associated subdisks 
that are both sequentially and contiguously arranged. 
A striped plex is a plex that distributes data evenly 
across each of its associated subdisks. This field is 
read-only and cannot be changed. 


The width of the stripes on the plex. If Striped plex layout 
has been specified, this field indicates the stripe width. This 
field should be blank if Concatenated plex layout has been 
specified. This field is read-only and cannot be changed. 


The number of subdisks associated with the plex. This 
field is read-only and cannot be changed. 


This field shows the name of the subdisk that is being used 
for logging on this plex. If there is no associated Dirty 
Region Logging subdisk (no logging in effect), this field is 
blank. This field is read-only and cannot be changed. 


An appropriate comment for the plex. The maximum 
length of the comment is 40 characters. 


Indicates whether the plex participates in LSM error 
policies. This field is read-only and cannot be changed. 


Permanent utility field 0. This is reserved for use, 
but can be changed. The maximum length of all 
Putil fields is 14 characters. 


Permanent utility fied 1. This field is reserved, 
but can be changed. 


Permanent utility fidd 2. This field is reserved, 
but can be changed. 


Temporary utility field 0. This is reserved for LSM 
use, but can be changed. The maximum length of 
all Tutil fields is 14 characters. 


Temporary utility field 1. This field is reserved, 
but can be changed. 


Temporary utility field 2. This field is reserved, 
but can be changed. 
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Field Description 


Kernel State The accessibility of the plex. This field is read-only 
and cannot be changed. 
Length The length of the plex. This field is read-only 
and cannot be changed. 
Number of I/O The number of failed |/O operations on this plex since the 
failures last boot. This field is read-only and cannot be changed. 


E.3 Subdisk Management 


The following sections provide information on menus and forms relating to 
subdisk management. 


E.3.1 Subdisk Menus 


You access the subdisk Advanced-Ops menu as shown here: 
Advanced-Ops — Subdisk 


This menu provides access to the following subdisk operations: 


Create 

Remove Subdisks 
Associate Subdisks 
Associate as Log Sd 
Dissociate Subdisks 
J oin Subdisks 

Split the Subdisk 
Help 


The Help selection accesses a Help window that displays information 
relevant to the subdisk operations. 


The following list describes how to access the subdisk menus: 


Create 


Advanced-Ops — Subdisk — Create 


This operation creates a subdisk on the selected LSM disk. An LSM 
disk must be selected. 


Form: Subdisk Create Form (described in Section E.3.2). 
Remove Subdisks 


Advanced-Ops — Subdisk — Remove Subdisks 


Using the Visual Administrator E-21 


This operation removes the selected subdisks. This is a permanent 
operation and cannot be undone. 


Requirements: 
- Atleast one subdisk icon must be selected. 


-  I|ftheselected subdisk is associated with a plex, it must be dissociated 
before it can be removed. Only free subdisks can be removed. 


e Associate Subdisks 
Advanced-Ops — Subdisk — Associate Subdisks 
This operation associates one or more subdisks with the selected plex. 
Requirements: 
- A plex icon and at least one subdisk icon must be selected. 
- Only nonassociated (free) subdisks can be associated. 
e Associate as Log Subdisk 
Advanced-Ops — Subdisk — Associate as Log Sd 


This operation associates the selected subdisk as a log subdisk with 
the selected plex. The resulting log subdisk icon has double borders to 
distinguish it from normal subdisks. 


Requirements: 

- A plex icon and a subdisk icon must be selected. 

- Only nonassociated (free) subdisks can be associated. 
- Theselected plex cannot already have a log subdisk. 


- Subdisks must be 2 or more sectors to enable logging in noncluster 
environments and 65 or more sectors for TruCluster environments. 


e Dissociate Subdisks 
Advanced-Ops — Subdisk — Dissociate Subdisks 


This operation dissociates one or more selected subdisks from their 
parent plexes. Both log subdisks and normal subdisks can be dissociated. 


Requirements: 
- Atleast one subdisk icon must be selected. 
- Only associated subdisks can be dissociated. 


- Thelast subdisk associated with a plex that is currently associated 
with a volume cannot be dissociated. The plex must be dissociated 
from its volume first. 


¢ Join Subdisks 
Advanced-Ops — Subdisk — Join Subdisks 
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This operation joins the selected subdisks to create a single subdisk. 
The resulting subdisk has the offset and name of the first subdisk (as 
arranged on the disk) and its length is the sum of the subdisk lengths. 


Requirements: 
- Atleast two subdisk icons must be selected. 
- Thesubdisks must be contiguous on the disk. 


- If the subdisks are associated, they must all be associated with the 
same plex and be contiguous on that plex. 


- Logging subdisks and subdisks associated with striped plexes cannot 
be joined. 


e Split a Subdisk 
Advanced-Ops — Subdisk —> Split the Subdisk 


This operation splits the selected subdisk into either two or many parts. 
The resulting subdisks will occupy the same region on the disk that the 
previous subdisk occupied. If the subdisk is associated with a plex, the 

resulting subdisks will also be associated with that plex. 


From the Split the subdisk menu, a submenu allows the user to indicate 
whether the subdisk is to be split into two or several parts: 


- Into 2 Subdisks — Split the selected subdisk into 2 subdisks. 


- IntoMoreThan 2 Subdisks — Split the selected subdisk into several 
subdisks. 


Requirements: 

- Only one subdisk icon can be selected. 
- Logging subdisks cannot be split. 
Forms: 

- Subdisk Split Into Two 

- Subdisk Split Into Many (Section E.3.2) 


E.3.2 Subdisk Forms 


Some subdisk operations result in the appearance of forms, which must be 

completed in order for that operation to proceed. Most forms provide a Help 
button, which contains information relevant to the fields and other aspects 

of that particular form. 


The following forms are accessed via subdisk-related selections from the 
Advanced-Ops menu: 


¢ Subdisk Create Form 
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Advanced-Ops — Subdisk — Create 


This form creates a subdisk according to the user’s specifications. The 
following table describes the fields in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 


Disk name The name of the LSM disk on which the subdisk is to be 
created. This field is read-only and cannot be changed. 


Subdisk name The name of the subdisk to be created. The name 
must be unique within this disk group. The maximum 
length of this field is 31 characters. 


Disk offset The length into the disk where this subdisk should be located. 
If no units are specified, sectors are assumed. This offset 
should not place this subdisk within the bounds of another 
subdisk on the disk or past the end of the disk. Only valid 
positive numbers are allowed in this field. 


Subdisk length The length of the subdisk to be created. If no units are 
specified, sectors are assumed. The length should not 
place this subdisk within the bounds of another subdisk 
on the disk or past the end of the disk. Only valid 
positive numbers are allowed in this field. 


Plex name The name of the plex with which the subdisk is to be 
associated. This must be a valid plex that already exists 
in this disk group. The maximum length of this field 
is 31 characters. This field is optional. 


Plex offset The offset of this subdisk into its associated plex. Only valid 
positive numbers are allowed in this field. This field is required 
only if a plex has been specified for association. If the subdisk 
is not to be associated with a plex, this field must be left blank. 


Comment An appropriate comment for the subdisk. The maximum 
length of the comment is 40 characters. This field is optional. 


PutilO Permanent utility field 0. This is reserved for Logical Storage 
Manager use, but may be changed. The maximum length of 
all Putil fields is 14 characters. This field is optional. 


Putill Permanent utility fidd 1. This field is reserved, but 
may be changed. The maximum length of this field is 
14 characters. This field is optional. 


Putil2 Permanent utility fidd 2. This field is reserved, but 
may be changed. The maximum length of this field is 
14 characters. This field is optional. 


¢ Subdisk Split Into Two 
Advanced-Ops —> Subdisk —> Split the Subdisk —> Into 2 Subdisks 
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This form splits the selected subdisk into exactly two subdisks. The first 
subdisk retains the name and size of the original one; the second subdisk 
adopts the name and size specified in this form. The following table 
describes the fields in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 


Present size The size of the subdisk to be split. This field is 
read-only and cannot be changed. 


Name of new Thename of the subdisk to be created from the original one. This 
subdisk must be a valid name and must be unique in this disk group. 


Size of new = Thesizeof thesubdisk to be created from the original one. This 
subdisk must bea valid number, greater than zero. The new subdisk size 
must be at least one sector less than the present subdisk size. 


e Subdisk Split Into Many 


Advanced-Ops — Subdisk — Split the Subdisk > Into More Than 
2 Subdisks 


This form splits the selected subdisk into several subdisks of equal 
sizes. The first subdisk retains the name and size of the original one 
the additional subdisks are automatically named by LSM. The following 
table describes the fields in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 
Original The name of the selected subdisk. This field is 
subdisk read-only and cannot be changed. 


Present size The size of the subdisk to be split. The original subdisk 
must contain enough sectors to accommodate the desired 
total number of subdisks for the split. This field is 
read-only and cannot be changed. 


Number of new Thetotal number of subdisks to be created by the split. There 
subdisks must bea sufficient number of sectors in the original subdisk to 
accommodate this number. This number should be at least 2. 


Requirements: The number of subdisks is limited by the amount of space 
left in the configuration database. 


E.3.3 Subdisk Properties Forms 


The following is the properties form that reveals the properties of a 
particular subdisk: 
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¢ Subdisk Properties Form 


To access the Subdisk Properties form, click MB3 on the desired subdisk 
icon. If the subdisk is undergoing analysis, press Shift-MB3 instead. 
This form provides detailed information on the attributes of a particular 
subdisk. The following table describes the fields in this form. 


The fields in this form are read/write fields, unless listed as read-only. 
Properties of the subdisk can be changed via this form by altering the 
current values in the appropriate read/write fields and then clicking 
on the Apply button. 


Field Description 


Disk name The name of the disk where the subdisk resides. This 
field is read-only and cannot be changed. 


Subdisk name The name of the subdisk. The name must be unique 
within this disk group. The maximum length of this 
field is 31 characters. The subdisk name can be changed 
by entering another name in this field. 


Disk offset The length into the disk where this subdisk is located, in 
sectors. This field is read-only and cannot be changed. 


Subdisk length The length of the subdisk. If no units are specified the 
number is assumed to be in sectors. This offset should 
not place this subdisk within the bounds of another 
subdisk on the disk or past the end of the disk. Only valid 
positive numbers are allowed in this field. 


Plex name The name of the plex with which the subdisk is associated. 
This field is read-only and cannot be changed. 
Plex offset The offset of this subdisk into its associated plex. If the 


subdisk is not associated, this field contains a zero. This 
field is read-only and cannot be changed. 


Comment An appropriate comment for the subdisk. The maximum 
length of the comment is 40 characters. 


Log Subdisk Indicates whether this subdisk is a Dirty Region Logging 
subdisk. This field is read-only and cannot be changed. 


PutilO Permanent utility fidd 0. This is reserved for LSM 
use, but may be changed. The maximum length of 
all Putil fields is 14 characters. 


Putill Permanent utility field 1. This field is reserved, but may be 
changed. The maximum length of this field is 14 characters. 
Putil2 Permanent utility field 2. This field is reserved, but may be 
changed. The maximum length of this field is 14 characters. 
TutilO Temporary utility field 0. This is reserved for LSM 


use, but may be changed. The maximum length of 
all Tutil fields is 14 characters. 
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Field Description 


Tutill Temporary utility field 1. This field is reserved, but may be 
changed. The maximum length of this field is 14 characters. 
Tutil2 Temporary utility field 2. This field is reserved, but may be 


changed. The maximum length of this field is 14 characters. 


Number of 1|O =Thenumber of failed !/O operations on this subdisk since the 
failures last boot. This field is read-only and cannot be changed. 


E.4 Disk Management 


The following sections provide information on menus and forms relating 
to disk management. 


E.4.1 Disk Menus 


E.4.1.1 


Both the Basic-Ops and Advanced-Ops menus provide access to disk-related 
operations. Most menus provide a Help selection, which contains information 
relevant to the items and operations listed in that particular menu. 


Basic-Ops Menu 


You access the Basic-Ops menu by selecting: 
Basic-Ops — Disk Operations 


This menu provides access to disk operations involving general disk 
maintenance. These operations use the automated approach to disk 
management. 


The Disk Operations menu provides the following selections: 
e Add Disks 

e Evacuate Subdisks 

e Replace Disks 

« Remove Disks 

« Help 


The Help selection accesses a Help window, which displays information 
relevant to the basic disk operations. 


The following list describes the menu selections you can access via the 
Basic-Ops menu: 


e« Add Disks 
Basic-Ops — Disk Operations —> Add Disks 
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This operation adds a disk to the Logical Storage Manager, placing 

it under LSM control. This involves initializing, analyzing, and 
partitioning the raw disk; initializing the disk for LSM use; and adding 
the disk toa disk group (if requested). 


Form: Add Disks Form (described in the Disk Forms section). 
¢ Evacuate Disks 
Basic-Ops — Disk Operations — Evacuate Disks 


This operation moves all subdisks from the selected disk to another disk 
in the same disk group. 


Requirements: The disk from which subdisks are to be evacuated must 
be selected. Both disks must belong to the same disk group. 


Forms: Evacuate Subdisks Form (described in the Disk Forms section). 
e Replace Disks 
Basic-Ops — Disk Operations — Replace Disks 


This operation replaces a disk. This is normally done when a failed 
disk needs to be replaced with a new one. This involves initializing 
and partitioning the raw disk; initializing the disk for LSM use; and 
replacing the old disk and associated disk media records with the new 
disk and its information. 


Requirements: A disk icon representing a failed disk must be selected. 
Forms: Replace Disks Form (described in the Disk Forms section). 

e Remove Disks 
Basic-Ops — Disk Operations — Remove Disks 


This operation removes a disk from a disk group and then removes the 
disk from LSM control. 


Requirements: A disk icon must be selected. 
E.4.1.2 Advanced-Ops Menu 
You access the Advanced-Ops menu selections by selecting: 
Advanced-Ops —> Disk 


This menu provides access to assorted disk operations using the manual 
approach to disk management. 


The Disk menu provides the following selections: 
e Initialize 

¢« Define 

« Remove 
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Online 
Offline 
Help 


The Help selection accesses a Help window, which displays information 
relevant to the advanced disk operations. 


The following list describes the menu selections you can access via the 
Advanced-Ops menu: 


Initialize 
Advanced-Ops — Disk — Initialize 


This operation identifies a disk to LSM and initializes the disk for 
LSM use. This involves installing a disk header and writing an empty 
configuration on the disk. A disk access record is created for the disk, 
unless such a record already exists. 


Requirement: The disk should not already be initialized. 
Form: Disk Init Form (described in the Disk Forms section). 
Define 


Advanced-Ops —> Disk — Define 


This operation defines a disk access record that enables LSM toscan the 
disk. This makes the disk accessible, but does not initialize the disk. 


Form: Define Disk Form (described in the Disk Forms section). 
Remove 
Advanced-Ops —> Disk > Remove 


This operation removes the LSM disk associated with the selected 
partitions from LSM control by removing the associated disk access 
records. If all partitions on a given disk are selected for removal at once, 
the disk is effectively removed from LSM control. 


Requirements: 


- Atleast one partition icon corresponding toa LSM disk must be 
selected. 


- TheLSM disks corresponding to the selected partitions cannot belong 
toa disk group at the time of removal. 


Online 
Advanced-Ops —> Disk —> Online 


This operation places the disk access record on a specified partition in an 
online state. During searches for disk |Ds or members of a disk group, 
online disks are checked. 
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Form: Disk Online Form (described in the Disk Forms section). 
Offline 


Advanced-Ops — Disk — Offline 


This operation places the disk access record on the selected partitions 
in an offline state. During searches for disk |Ds or members of a disk 
group, offline disks are ignored. 


Requirements: 
- Atleast one partition icon must be selected. 
- Thedisks corresponding tothe selected partitions must be initialized. 


- The selected partition icon cannot bein use (shaded and associated 
with a LSM disk). 


E.4.2 Disk Forms 


Some disk operations result in the appearance of forms. You must complete 
these forms in order for that operation to proceed. Most forms provide a 
Help button that provides access to information relevant to the fields and 
other aspects of that form. 


E.4.3  Basic-Ops Forms 


The following forms are accessed via disk-related selections from the 
Basic-Ops menu. 


Add Disks Form 


Basic-Ops — Disk Operations —> Add Disks 


This form places a disk under Logical Storage Manager control. The 
following table describes the fields in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 
New disk The name of the new physical disk in the form dsknn, for 
name example, dsk10. The name must be unique within this 


disk group. You can also place specific partitions on a disk 
under LSM control. For example, dsk3g would put the 
g partition on dsk3 under LSM control. 


Disk group The name of the disk group to which this disk is to be added. 
The named disk group must exist. If no name is provided, it 
will not be added to a disk group. This field is optional. 


Replace Disks Form 
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Basic-Ops — Disk Operations — Replace Disks 


This form replaces an existing LSM disk that has failed with another 
one. The following table describes the fields in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 


Old LSM disk name The name of the failed (collapsed or disconnected) 
LSM disk in this disk group. This field is 
read-only and cannot be changed. 


New physical disk name The name of the new physical disk that is to 
replace the existing one. The name should be in 
the form dsknn, for example, dsk10. The new 
name must be unique in this disk group. 


Evacuate Subdisks Form 
Basic-Ops — Disk Operations > Evacuate Subdisks 


This form transfers subdisks from one LSM disk to another. The 
following table describes the fields in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 


Disk group name The name of the disk group to which both disks belong. 
Both disks must share the same disk group. 


Evacuate From Thename of the LSM disk from which the subdisks 
are to be evacuated. 


To The name of the LSM disk to which the subdisks are to be 
moved. This field is optional. However, if no target disk is 
specified, the subdisks are evacuated to one or more random 
disks (depending on disk space availability). 


E.4.3.1  Advanced-Ops Forms 


The following forms are accessed via disk-related selections from the 
Advanced-Ops menu: 


Disk Init Form 


Advanced-Ops — Disk — Initialize 


This form initializes a disk for LSM use. The following table describes 
the fields in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 
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Field Description 


Public Device The pathname of the device node that represents a partition 
available for use. This name must be a valid entry in 
/dev/disk. A namein the form dsknn is used to assign the 
full disk under LSM control. The disk dsknn would be added 
as a sliced LSM disk. Before a sliced disk can be defined, 
change the disk label to have LSM disk label tags. 


A name in the form dsknnp is used to assign partition 
pon disk dsknn under LSM control. The disk partition 
dsknnp is added as a simple LSM disk. 


Device Type Thedesired disk type. The simple type (default) assumes that 
the public and private regions are stored on the same disk 
partition, with the public region following the private region. 
The sliced type assumes that the public and private regions 
are stored on different disk partitions. Before initializing 
the disk, change the disk label to have LSM disk label 
tags. The nopriv type has no private region and log and 
configuration copies cannot be written to the disk. 


Public length The length of the public region of the disk. If zero is provided 

(0 for whole as the length, the Logical Storage Manager computes a default 

device) value from available partition table information. This length 
must be valid and cannot exceed the length of the disk. 


Private The length of the private region of the disk. When one is not 

Length specified, LSM chooses a default value. This length must be 
valid and cannot exceed the length of the disk. For a sliced 
disk, the length cannot exceed the size of the partition chosen 
for the private region. This field is optional. 


Number of The number of configuration copies to be stored in the private 
config copies region of this disk. The default value is one copy. 


Comment: A comment appropriate for the LSM disk. The maximum length 
of the comment is 40 characters. This field is optional. 


¢ Define Disk Form 


Advanced-Ops -—> Disk — Define 


This form defines a disk. The following table describes the fields in this 
form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 
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Field Description 


Public Device The pathname of the device node that represents a partition 
available for use. This name must be a valid entry in 
/dev/disk. A name in the form dsknn is used to assign the 
full disk under LSM control. The disk dsknn would be added 
as a sliced LSM disk. A name in the form dsknnp is used to 
assign partition p on disk dsknn under LSM control. The 
disk partition dsknnp would be added as a simple LSM disk. 


Device Type The desired disk type. The simple type (default) assumes 
that the public and private regions are stored on the 
same disk partition, with the public region following the 
private region. The sliced type assumes that the public and 
private regions are stored on different disk partitions. The 
nopriv type has no private region and log and configuration 
copies cannot be written to the disk. 


Public Length (0 The length of the public region of the disk. If zero is 

for whole disk) — provided as the length, LSM computes a default value from 
available partition table information. This length must be 
valid and cannot exceed the length of the disk. 


Offline Indicates whether to initially place the disk in the 
offline state. The default is No. 


Comment A comment appropriate for this Logical Storage Manager 
disk. The maximum length of the comment is 40 
characters. This field is optional. 


Disk Online Form 


Advanced-Ops —> Disk —> Online 


This form places a disk on line. The following table describes the fields 
in this form. 


Field Description 
Device The disk access name of the disk to be placed onlined. This must 
name be a valid disk access name. This field is required. 


Free Space Form 


To access the free space form, click MB3 on a gap between subdisk icons 
in aLSM disk icon. 


This form provides information about a specific region of an LSM disk 
that contains free space. 


Free space results when subdisks are removed for some reason, making 
the space that they occupied available for use. Free space is visually 
represented as a gap or hole between subdisks that reside on a LSM disk 
icon. The following table describes the fields in the form. All fields in 
this form are read-only and cannot be changed. 
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Field Description 


Device The name of the LSM disk where this free space resides. 
Hole offset The offset into the LSM disk where this free space extent begins. 


Holesize Thesizeof this free space extent. The units used are specified 
by the user under the Options pull down menu. 


E.4.4 Disk Properties Forms 
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Properties forms exist for LSM disks, physical disks, and partitions. The 
following list describes these forms: 


LSM Disk Properties Form 


To access the LSM disk properties form, click MB3 on desired LSM disk 
icon. (If the LSM disk icon is undergoing analysis, press Shift-MB3 
instead.) 


This form provides detailed information on the attributes of a particular 
LSM disk that is under LSM control. The information displayed in this 
form actually corresponds to the disk media record associated with a 
disk. The following table describes the fields in this form. 


The fields in this form are read/write fields, unless listed as read-only. 
Properties of the disk can be changed via this form by altering the 
current values in the appropriate read/write fields and then clicking 
on the Apply button. 


Field Description 
LSM disk The name of the LSM disk. 
name 


Disk Access Thenameof the disk access record that corresponds to this disk 
media record. This field is read-only and cannot be changed. 


Disk Type The type with which this disk media record was created. 
This field is read-only and cannot be changed. 


Public Region The name of the public region of this disk. This field 
is read-only and cannot be changed. 


Private Region The name of the private region of this disk. If there is 
no private region then this field will be blank. This field 
is read-only and cannot be changed. 


Public Region The offset, in sectors, of the public region on the disk. This 


Offset field is read-only and cannot be changed. 
Private Region The offset, in sectors, of the private region on the disk. If 
Offset there is no public region, then this field will display zero. 


This field is read-only and cannot be changed. 
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Field Description 


Public Region The length, in sectors, of the public region on the disk. 


Length This field is read-only and cannot be changed. 

Private Region The length, in sectors, of the private region on the disk. If 

Length there is no private region, this field will display zero. This 
field is read-only and cannot be changed. 

Disk The attributes of this LSM disk. This field is read-only 

Attributes and cannot be changed. 

Comment The user-specified comment for this LSM disk. The maximum 
length of the comment is 40 characters. 

PutilO Permanent utility field 0. This is reserved for LSM 


use, but may be changed. The maximum length of 
all Putil fields is 14 characters. 


Putill Permanent utility fied 1. This field is reserved, 
but may be changed. 
Putil2 Permanent utility field 2. This field is reserved, 
but may be changed. 
TutilO Temporary utility field 0. This field is reserved, but may be 
changed. The maximum length of all Tutil fields is 14 characters. 
Tutill Temporary utility field 1. This field is reserved, but may be 
changed. The maximum length of this field is 14 characters. 
Tutil2 Temporary utility field 2. This field is reserved, but may be 


changed. The maximum length of this field is 14 characters. 


Maximum The maximum amount of free space available on this LSM 

Free Space disk. This does not take disk extents into account. This 
number assumes every free sector on the LSM disk is usable. 
This field is read-only and cannot be changed. 


Physical Disk Properties Form 


To access the physical disk properties form, click MB3 on the desired 
physical disk icon. 


This form provides detailed information on the attributes of a particular 
physical disk. The following table describes the fields in this form. 


All fields in this form are read-only and cannot be changed. 


Field Description 


Device The raw device node for this physical disk. 


DeviceType A brief description the device type. Possible device types 
include SCSI hard drive and Floppy. 


Cylinders The number of cylinders on this disk. 


Tracks The number of tracks per cylinder. 
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Field Description 


Sectors The number of sectors per track. 
Sector Size The size, in bytes, of each sector on this disk. 
Total Size The total size of the disk, in sectors. 


¢ Partition Properties Form 


To access the partition properties form, click MB3 on the desired 
partition icon. 


This form provides detailed information on the attributes of a particular 
partition. The following table describes the fields in this form. 


All fields in this form are read-only and cannot be changed. 


Field Description 


Device The device node that the LSM Visual Administrator 
uses to communicate with this disk. 


Start Sector The sector on the physical disk where this partition begins. 
Size The length of this partition. 
Type The identification tag associated with this partition. 


Disk Media The disk media record that corresponds to this partition. 
If this field is empty, the partition has not been 
initialized with a disk media record. 


E.5 Disk Group Management 


The following sections provide information on menus and forms relating 
to disk group management. 


Note 


With the Visual Administrator, partition icons represent 
partitions described by disk access records. 


E.5.1 Disk Group Menus 
You access disk group operations via the Advanced-Ops menu, as shown here: 
Advanced-Ops — Disk Group 


TheAdvanced-Ops menu provides access to the following disk-related menus. 
¢ Initialize 
e Import Disk Groups 
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Deport Disk Groups 
Add Disk 

Remove Disks 
Disconnect Disks 
Reconnect Disks 
Help 


The Help selection accesses a Help window that displays information 
relevant to the disk group operations. 


The following list describes the disk group menu options: 


Initialize 
Advanced-Ops —> Disk Group — Initialize 


This operation defines a new disk group with a name you specify. The 
new disk group contains one or more LSM disks corresponding to the 
partitions you select. 


Requirements: At least one partition icon must be selected. 


Form: Initialize Disk Group Form (described in the Disk Group Forms 
section). 


Import Disk Group 
Advanced-Ops — Disk Group > Import Disk Group 


This operation imports a disk group to make that disk group available on 
the local machine. If the name of a deported disk group is known, this 
operation can be used to make that disk group accessible again. 


Form: Import Disk Group Form (described in the Disk Group Forms 
section). 


Deport Disk Group 
Advanced-Ops — Disk Group — Deport Disk Group 


This operation disables access to a disk group. A deported disk group 
is no longer accessible and its view window disappears. Once deported, 
a disk group can be reimported. 


Requirements: A disk group cannot be deported if any volumes in that 
disk group are currently open. 


Form: Deport Disk Group Form (described in the Disk Group Forms 
section). 


Add Disk 
Advanced-Ops — Disk Group — Add Disk 
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This operation adds an LSM disk corresponding to the selected partition 
icon toa disk group. This involves creating a disk media record for the 
disk to be added. Partitions representing disks that already belong to 
disk groups cannot be added to disk groups. 


Requirements: 

- One partition icon must be selected. 

- Theselected partition cannot already belong toa disk group. 

- Only onedisk can be added toa disk group at a time. 

Form: Add Disk Form (described in the Disk Group Forms section). 
« Remove Disks 

Advanced-Ops —> Disk Group > Remove Disks 


This operation removes the selected LSM disks froma disk group. Disks 
are removed from the disk group in which they reside. Any subdisks 
that exist on the selected disks must be removed before the disk can 

be removed. 


Requirements: 

- Atleast oneLSM disk icon must be selected. 

- Only disks associated with the specified disk group can be removed. 
- Disks containing any subdisks cannot be removed. 


- Only disks in the same disk group can be selected for removal in 
a single operation. 


- Thelast disk in a disk group cannot be removed. The disk group 
itself must be deported in order for its last disk to be removed. 


¢ Disconnect Disks 


Advanced-Ops — Disk Group —> Disconnect Disks 


This operation disables the selected LSM disk, making it unavailable 
for use within its disk group. This involves dissociating the disk media 
record from its disk access record. 


Requirements: 
- Atleast one LSM disk icon must be selected. 


- TheLSM disk icons must contain a disk media record at the time of 
selection. 


e Reconnect Disks 


Advanced-Ops — Disk Group — Reconnect Disks 


This operation enables a LSM disk that has previously been disconnected. 
This involves connecting the selected LSM disk’s disk media record 
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with the selected disk access record. Although the LSM disk must be 
disconnected, it does not necessarily have to be reconnected to its former 
partition (disk access record). 


Requirements: 
- OneLSM disk icon and one partition icon must be selected. 


- Neither the LSM disk icon nor the partition icon can already be 
connected. 


E.5.2 Disk Group Forms 


Some disk group operations result in the appearance of forms, which must 
be completed in order for that operation to proceed. Most forms provide a 
Help button, which contains information relevant to the field and other 
aspects of that particular form. 


The following forms are accessed via disk group-related selections from the 
Advanced-Ops menu: 


¢ Initialize Disk Group Form 
Advanced-Ops —> Disk Group — Initialize 
This form defines a new disk group consisting of selected disks. 
The following table describes the field in this form. 


Field Description 


Disk group The name of the new disk group. This must be a valid and 
unique name. This field is required. This is a read/write field. 


e Import Disk Group Form 


Advanced-Ops — Disk Group > Import Disk Group 


This form makes the specified disk group available to the system. The 
following table describes the field in this form. 


Field Description 


Disk group Thename of the disk group to be imported and made available to 
the system. This must be a valid and unique disk group name. 
This field is required. This is a read/write field. 


¢ Deport Disk Group Form 


Advanced-Ops — Disk Group — Deport Disk Group 


This form makes the specified disk group inaccessible to the system. The 
following table describes the fields in this form. 
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Field Description 


Disk group The name of the disk group to be deported and made 
inaccessible to the system. This must be a valid disk group. 


Requirements: The root disk group (rootdg) cannot be deported. 
¢« Add Disk Form 


Advanced-Ops —> Disk Group —> Add Disk 


This form adds an LSM disk to a disk group. The following table 
describes the fields in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 


Disk group The name of the disk group to which the LSM disk is to be 
added. This must be a valid disk group. This field is required. 


Disk media The name of the LSM disk to be created. The disk media name 
name must be unique. By default, a unique name is generated. If 
this field is left blank, then the disk access name is used. 


E.6 Projection Analysis 


The following sections provide information on menus and forms relating 

to projection and analysis. |n addition, tables are provided to summarize 
various aspects of projection and analysis behavior. You can access these 
operations as follows: 


¢ Projection 


Projection operations are accessed via the Projection menu. This menu 
is located in view windows such as View of the rootdg disk group. The 
Projection menu starts or stops projection, and highlights any free 
subdisk icons. 


Projection can also be started or stopped by pressing Shift-MB2 with the 
pointer positioned on the desired icon. 
e« Analysis 


Analysis operations are accessed via the Analyze menu. This menu 
is located in view windows such as View of the rootdg disk group. 
The Analyze menu can be used to starts or stops analysis and sets 
analysis-related preferences. 
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E.6.1 Projection 


Icon projection provides the user with visual information about the 
relationships between icons. When projection is started for an icon, all other 
icons (representing LSM objects) associated with that particular one are 
highlighted, no matter which views they occupy. I cons can be placed under 
projection either individually or in multiples. Projection highlighting can 
accumulate on a given icon when that icon is undergoing projection from 
more than one source. 


E.6.2 Projection Menus 


The following list describes the menus, submenus, and menu selections you 
can access via the Projection menu: 


Icon Projection 


Projection — Icon Projection 


This menu provides access to projection options used to start or stop 
projection for icons. 


Start 


Projection — Icon Projection —> Start 


This option starts projection for the selected icons. When projection 

is started, all icons related to the selected icons are highlighted. 
Highlighting occurs for related icons in any view windows. If the selected 
icon has no associated objects, the Visual Administrator issues a warning 
to this effect. 


Requirements: 
- At least one icon must be selected. 
- Physical disk and partition icons cannot be selected for projection. 


- Theselected icons must be associated with at least one other icon in 
order for projection to take effect. 


Stop 


Projection — Icon Projection — Stop 


This option stops projection for the selected icons. When projection 
is stopped, all icons related to the selected icons lose their projection 
highlighting. 


Requirement: At least one icon must be selected. If the selected icon is 
not undergoing projection, the Visual Administrator ignores the stop 
request. 


Stop All 
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Projection — Icon Projection — Stop All 


This option stops projection for all icons that are currently undergoing 
selection. 


e Show Free Subdisks 


Projection —> Show Free Subdisks 


This menu selection determines whether free subdisks should be 
highlighted or not. When Show Free Subdisks is turned on, the Visual 
Administrator highlights all unassociated subdisks (representing 
unallocated disk space). Once turned on, any future free subdisks are 
automatically highlighted. F ree subdisk icons can be used by designating 
them to objects, but the LSM Visual Administrator interface cannot 
automatically use free subdisks as free space. Free subdisk projection is 
either started or stopped across all Visual Administrator views. The start 
or stop preference is also retained for a particular user in future sessions. 


From the Show Free Subdisks menu, a submenu allows you to indicate 
whether or not to highlight free subdisks: 


Option Description 


Start Start highlighting free subdisks immediately and continue 
to do so until instructed to stop. 


Stop Stop highlighting free subdisks. 


E.6.3 Projection Relationships 


Table E-3 summarizes the projection relationships that are highlighted for 
particular icon types. If noicons of the correct type are associated with the 
selected icon, then nothing is highlighted. 


Table E-3: Projection Table 
Icon Selected Icons Highlighted 


Volume All subdisks associated with any plex associated with the volume 
Plex All subdisks associated with the plex 
Subdisk Associated plex and volume, and all other subdisks 
associated with the plex 
LSM Disk All plexes associated with the subdisks that reside on the disk 


E.7 Analysis 


Analysis is the LSM Visual Administrator’s way of displaying statistics on 
the performance of various LSM objects. 
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Statistics are displayed both visually (via color or pattern) and numerically 
(via pop-up statistics forms). 


E.7.1 Analysis Menus 


The following menu selections are accessed via the Analyze menu: 


Start 


Analyze —> Start 


This menu selection begins analysis of the selected icons. These icons 
are added to the list of objects being analyzed. Only volume and LSM 
disk icons can be analyzed. Once analysis is activated, the selected icons 
begin to display information about their performance characteristics. 


Requirement: At least one volume or LSM disk icon must be selected. 
Stop 
Analyze — Stop 


This menu selection terminates analysis of the selected icons. These 
icons are removed from the list of objects being analyzed. When analysis 
stops, the selected icons return totheir preanalysis states. When analysis 
is stopped for oneicon, other icons undergoing analysis are not affected. 


Requirements: 

- Atleast one volume or LSM disk icon must be selected. 
- Theselected icons must be undergoing analysis. 

Stop All 

Analyze —> Stop All 


This menu selection automatically terminates analysis of all icons in all 
views. All icons return to their preanalysis states. 


Requirements: Analysis must be in effect. 
Parameters 


Analyze — Parameters 


This menu selection accesses the Analysis Parameters form, which sets 
user preferences for how analysis is to be conducted. 


Form: Analysis Parameters F orm (described in the Analysis Forms 
section). 


E.7.2 Analysis Forms 


The following forms are accessed via the Analyze menu: 


Analysis Parameters Form 
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Analyze — Parameters 


This form sets user preferences for conducting analysis. The following 
table describes the fields in this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 


Sample Rate Determines the time interval between data samples. This 
field is divided into two sections: the slider bar selects the 
interval (1-60) and the menu to the right selects units 
of time (seconds or minutes). The default is 5 seconds. 

A shorter interval means the data will be updated more 
often, but is also a higher load on the system. 


Volume Specifies the high and low values that decide the coloring 
Parameters (or pattern) of the volume icons. 

Disk Specifies the high and low values that decide the coloring 
Parameters (or pattern) of the LSM disk icons. 

Subdisk Specifies the high and low values that decide the coloring 
Parameters (or pattern) of the subdisk icons. 

Log File The name of the file for the statistics log. If the file does not 


exist, it is binary file created. The file name is taken to be 
relative unless a path name is given. To stop logging to the 
file, delete the file name text in this field. This field is optional. 
To view the log file, you must run /usr/bin/1lsmlog2text 
filename on the file to process it for viewing. 


Requirements: 


- For each set of high/low parameters, the high parameter must be 
greater than the low parameter. 


- Theuser must have access to the specified log file. 
e Analysis Statistics Form 


To access the analysis statistics form, click MB3 on desired the icon 
that is being analyzed. 


This form displays analysis statistics relevant to the selected volume or 
LSM disk icon. This form applies only to volume or disk icons that are 
undergoing analysis. The following table describes the fields in this form. 
All fields in this form are read-only and cannot be changed. 


Field Description 


Reads The number of times the object was read from 
during the last interval. 
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Field Description 


Writes The number of times the object was written to 
during the last interval. 


Total R/W The total number of reads and writes during the last interval. 


Blocks Read The number of disk blocks read from the object 
during the last interval. 


Blocks Written The number of disk blocks written to the object 
during the last interval. 


Total Blocks The total number of blocks read from or written to 
the object during the last interval. 


Avg Read Time The average time, in milliseconds, that it took for a 
read operation to complete. This is equal to the number 
of number of reads during the last interval divided 
by the total time spent on reads. 


Avg Write The average time, in milliseconds, that it took for a write 
Time operation to complete. This is equal to the number of writes 
during the last interval divided by the total time spent on writes. 


Interval The actual time, in seconds, since the last data was sampled. 
This might vary slightly from the specified interval time due 
to uncontrollable variances from system to system. 


Requirement: The icon selected by clicking MB3 must be undergoing 
analysis. 


E.7.3 Analysis Table 
Table E-4 summarizes the default colors and patterns associated with 


the various levels of analysis. These defaults can be changed using the X 
resources for dxlsm. See the dx1lsm(8) reference page for more information. 


Table E-4: Analysis Table 


Analysis Level Color Bitmap Pattern 
low green cross_weave 
medium yellow root_weave 
high red wide_weave 


E.8 UFS Management 


This section provides information on Visual Administrator UFS file system 
operations. You access UFS operations via the BasicOps menu. This menu 
is located in view windows, such as View of the rootdg disk group. This 
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menu provides access to UFS operations involving general file system 
maintenance, and is accessed by selecting: 


Basic-Ops — UFS Operations 


You can access the following menu selections via the BasicOps menu. 
e« Create 

« Make File System 

* Mount 

« Unmount 

« Check File System (fsck) 

¢ Display Properties 

¢ Help 


The Help selection accesses a Help window which displays information 
relevant to the available file system operations. 


E.8.1 File System Menus 


The following list describes the file system operations menu items: 
* Create 


Basic-Ops — UFS Operations — Create 


This operation creates a file system on an underlying volume. This is 
done by creating a volume on one or more disks and then creating the 
file system on that volume. 


You can select oneor more disks on which to create the volume (providing 
that there is sufficient space on the disks). If you do not specify any 
disks, LSM automatically determines which disks to use based on 
available free space. 


From the Create menu, select the type of volume to be created from a 
submenu listing two of the basic types of volumes: 


Type Description 


Simple Creates a simple, concatenated volume whose subdisks are 
arranged both sequentially and contiguously within a plex. 


Striped Creates a volume with data spread fairly evenly across 
multiple disks by way of striping. Stripes are relatively 
small, equally sized fragments that are allocated alternately 
to the subdisks of each plex. 
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If a mirrored volume is desired, a simple or striped volume must be 
created and then mirrored using the Add Mirror option from the Volume 
Operations menu. 


Requirements: 
- Only disks in the same disk group can be selected. 
- Only LSM disks (disks under LSM control) can be selected. 


- If striping is to bein effect, at least two disks are required in order 
for the operation to succeed. 


Forms: 

- Simple Volume/FS Create 

- Striped Volume/FS Create 

Make File System 

Basic-Ops — UFS Operations — Make File System 


This operation makes a file system on an existing volume. The user 
selects the volume on which to place the new file system, and specifies 
the mount point if the file system is to be mounted immediately. 


Requirements: 

- A volume icon must be selected. 

- Theselected volume must be enabled. 

- Only one mounted file system can exist on each volume. 
Form: Make File System F orm (described in Section E.8.2). 
Mount 

Basic-Ops — UFS Operations — Mount 


This operation mounts the file system that resides on the selected 
volume. This operation assumes that the selected volume already 
contains a valid file system. The Visual Administrator has no way of 
knowing whether a valid, unmounted file system already exists on a 
given volume. You must make sure of the existence of an unmounted file 
system on a volume, as well as that file system's type. 


Requirements: 
- A volume icon must be selected. 


- A valid, unmounted file system must already exist on the selected 
volume. 


Form: Mount File System F orm (described in Section E.8.2). 
Unmount 


Basic-Ops — UFS Operations — Unmount 
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This operation unmounts the file systems that resides on the selected 
volumes. The file system can be unmounted only if the mount point 
is not busy. 


Requirements: 

- Atleast one volume icon must be selected. 

- Theselected volume must contain a mounted file system. 
Check File System 


Basic-Ops — UFS Operations > Check File System (fsck) 


This operation checks the file systems on the selected volumes for 
consistency (using fsck). The file system to be checked must currently 
be unmounted. 


Requirements: 

- Atleast one volumeicon must be selected. 

- Theselected volumes must contain an unmounted file system. 
Form: File System Check Form (described in Section E.8.2). 
Display Properties 

Basic-Ops — UFS Operations — Display Properties 


Display information for file systems mounted on the system. You can 
select the file system for which information is to be displayed from a list 
of all mounted file systems. If a volume is selected, the properties for the 
file system that resides on that volume is displayed by default. 


E.8.2 File System Forms 


E.8.2.1 


Some file system operations result in the appearance of forms that you must 
complete in order for that operation to proceed. Most forms provide a Help 
button that provides access to information relevant to the fields and other 
aspects of that particular form. 


Basic-Ops Forms 


The following list describes how to access forms via file system-related 
selections from the BasicOps menu: 


Simple Volume/F S Create Form 


Basic-Ops — UFS Operations — Create — Simple 


This form creates a concatenated volume and then creates a file system 
on the new volume. The form is divided into two sections, one for volume 
creation and the other for file system creation. Most of the form fields 
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are already set to the defaults for the creation of a new volume and file 
system. The following table describes the fields for this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field 


Description 


Volume name 


Volume size 


Usage Type 


Create file system 


FS type 
Mount file system 


Mount point 


Mount 
automatically 


The name of the volume to be created. The name 
must be unique within this disk group. The maximum 
length of this field is 31 characters. 


The desired volume size. The size should be entered 
as a number followed immediately by the letter k, 

m, or s to indicate kilobytes, megabytes, or sectors, 
respectively. If no unit is specified, the default is 
sectors. The volume size should be less than or equal 
to the available free space of the disks. 


The desired usage type. The fsgen file system is the 
generic usage type, which assumes that the volumeis being 
used by a file system. The gen file system is the generic 
usage type, which makes no assumptions regarding the 
data content of the volume. The default is fsgen. 


Indicates whether a file system is to be created. When 
this form is invoked from the UFS Operations menu, the 
default is to create a file system (Yes). All fields below this 
field are accessible only when Yes is specified here. 


UFS is the only currently supported file system type. 


Indicates whether the file system should be mounted after 
creation. If the answer is Yes (the default), a mount point 
must also be specified in the next field. All fields below this 
field are accessible only when Yes is specified here. 


The desired mount point for the new file system. If the 
specified mount point does not already exist, the Visual 
Administrator automatically creates it. This field is 
required if the file system is to be mounted. 


Indicates whether this file system should be mounted 
every time the system comes up (by placing an entry 
in /etc/fstab). The default is Yes. 


Striped Volume/F S Create Form 


Basic-Ops — UFS Operations — Create —> Striped 


This form creates a striped volume and creates a file system on the new 
volume. The form is divided into two sections, one for volume creation 
and the other for file system creation. Most of the form fields are already 
set to the defaults for the creation of a new volume. The following table 
describes the fields for this form. 
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Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field 


Description 


Volume name 


Volume size 


Usage Type 


Number of stripes 


Stripe width 


Create file system 


FS type 


Mount file system 


The name of the volume to be created. The name 
must be unique within this disk group. The maximum 
length of this field is 31 characters. 


The desired volume size. The size should be entered as 
a number followed immediately by the letter k, m, or s to 
indicate kilobytes, megabytes, or sectors, respectively. 

If no unit is specified, the default is sectors. If the size 
is not wholly divisible by the stripe width, LSM adjusts 
the volume size up to the next even multiple in order to 
create the volume. For a striped volume, the volume size 
should be calculated as follows: vol_size =stripe_ width 

* number_of_stripes * n, where n is a number greater 
than zero. The volume size should be less than or equal 
to the available free space of the disks. 


The desired usage type. The fsgen type is the file system 
generic usage type, which assumes that the volume is 
being used by a file system. The gen type is the generic 
usage type, which makes no assumptions regarding the 
data content of the volume. The default is fsgen. 


The number of stripes that the volume's plex is to have. 
This is effectively the number of disks on which the volume 
is to be created. If some number of disks have already 
been selected, that number of stripes appears in this field. 
This number corresponds to the number of disks across 
which data will be striped. If no number is specified, 

an appropriate number (usually 2) is used. 


The width of the stripes on the plex that this volume 
will have. The value specified might be optimized for the 
particular application. However, the default value of 128 
sectors is as a good stripe width for most systems. 


Indicates whether a file system is to be created. When 
this form is invoked from the UFS Operations menu, the 
default is to create a file system (Yes). All fields below this 
field are accessible only when Yes is specified here. 


UFS is the only currently supported file system type. 


Indicates whether the file system should be mounted after 
creation. If the answer is Yes (the default), a mount point 
must also be specified in the next field. All fields below 
this field are accessible only when Yes is specified here. 
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Field Description 


Mount point The desired mount point for the new file system. If the 
specified mount point does not already exist, the Visual 
Administrator automatically creates it. This field is 
required if the file system is to be mounted. 


Mount Indicates whether this file system should be mounted 
automatically every time the system comes up (by placing an entry 
in /etc/fstab). The default is Yes. 


Make File System Form 


Basic-Ops — UFS Operations — Make 


This form makes a file system (using newfs) according to your 
specifications. The following table describes the fields for this form. 


Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless they are listed 
as read-only. 


Field Description 


Device name Displays the block device on which to make the file system, 
which corresponds to the name of the selected volume. 
This field is read-only and cannot be changed. 


File system size Displays the length of the file system to be made. If no 
units are specified, sectors are assumed. This length 
should typically correspond to the length of the volume 
on which the file system is to be made, although it 
can be altered for special circumstances. 


FS Type UFS is the only currently supported file system type. 


Mount file system Indicates whether the file system should be mounted after 
creation. If the answer is Yes (the default), a mount point 
must also be specified in the next field. All fields below 
this field are accessible only when Yes is specified here. 


Mount point The desired mount point for the new file system. If the 
specified mount point does not already exist, the Visual 
Administrator automatically creates it. This field is 
required if the file system is to be mounted. 


Mount Indicates whether this file system should be mounted 
automatically every time the system comes up (by placing an entry 
in /etc/fstab). Yes is the default. 


Mount File System Form 


Basic-Ops — UFS Operations > Mount 


This form mounts a file system that already exists on a selected volume. 
The following table describes the fields for this form. 
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Most fields in this form are required; those that are optional are listed 
here. Fields in this form are read/write fields, unless listed as read-only. 


Field Description 


Device name Displays the block device on which to make the file system, 
which corresponds to the name of the selected volume. 
This field is read-only and cannot be changed. 


FS Type UFS is the only currently supported file system type. 


Mount point The desired mount point for the file system. If the 
specified mount point does not already exist, the Visual 
Administrator automatically creates it. The Visual 
Administrator attempts to provide a default mount point, 
which it obtains by scanning /etc/fstab. 


Mount Indicates whether this file system should be mounted 
automatically every time the system comes up (by placing an entry 
in /etc/fstab). No is the default. 


e File System Check Form 


Basic-Ops — UFS Operations — Check File System (fsck) 


This form checks a file system that exists on a volume but is not currently 
mounted. The following table describes the fields for this form. 


The fields in this form are required. Fields in this form are read/write 
fields, unless listed as read-only. 


Field Description 


Volume Displays the name of the volume containing the file system to be 
checked (with fsck). This field is read-only and cannot be changed. 


FS type Indicates the type of the file system to be checked. 


E.8.2.2 File Systems Properties Form 
The following discussion describes the properties form. This form reveals 
the properties of a particular file system: 
¢« File System Properties Form 


Basic-Ops — UFS Operations — Display Properties 


This form provides detailed information on the attributes of a particular 
file system. This properties form contains a list of mounted file systems, 
from which you can select the file system whose properties are to be 
displayed. The following table describes the fields for this form. 


All fields in this form are read-only and cannot be changed. 
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Field 


Description 


Mount Point 
Device 

Block Size 
Default block size 


Total disk space 


Disk space 
available 


Capacity 


Total files 


Free files available 


FS type 


Max file name 
length 


FS attributes 


The mount point of this file system. 

The block device on which this file system resides. 
The block size of this file system. 

Fundamental file system block size. 


Number of megabytes of disk storage on this file 
system available on the disk. 


Number of megabytes of disk storage on this file 
system that are available for use. 


Percentage of the total disk storage space still 
available for use. This is the free space available 
divided by the total disk space. 


The maximum number of files allowed on this file system. 


The number of files that still can be created 
on this file system. 


The file system type (such as UFS). 


The maximum number of characters for a file name on this 
file system. This restriction is imposed by the file system. 


Indicates attributes associated with this file system: 
read-only indicates a file system that cannot be written to. 
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Glossary 


The following are LSM terms and definitions. 


concatenated plex 


A plex that uses subdisks on one or more disks to create a virtual contiguous 
region of storage space that is accessed linearly. If LSM reaches the end of a 
subdisk while writing data, it continues to write data to the next subdisk, 
which can physically exist on the same disk or a different disk. This layout 
allows you to use space on several regions of the same disk, or regions of 
several disks, to create a single big pool of storage. 


description set 

A set of files that are saved using the volsave(8) command and can be used 
to restore an LSM configuration. By default, an LSM description set is saved 
in atime-stamped directory under the /usr/var/1sm/db directory. 


disk 
Disks exist as two entities: 


¢ A physical disk on which all data is ultimately stored and which exhibits 
all the behaviors of the underlying technology. 


« AnLSM representation of disks which, while mapping one-to-one with 
the physical disks, is just a presentation of units from which allocations 
of storage are made. 


The difference is that a physical disk presents the image of a device with a 
definable geometry with a definable number of cylinders, heads, and so on 
while an LSM disk is simply a unit of allocation with a name and a size. 


See also subdisk, volume 


disk access record 


A configuration record that defines the path to a disk. Disk access records 
most often include a unit number. LSM uses the disk access records stored 
in a system to find all disks attached to the system. Disk access records do 
not identify particular physical disks. 


Through the use of disk IDs, LSM allows you to move disks between 
controllers or to different locations on a controller. When you move a disk, 
a different disk access record is used to access the disk, although the disk 
media record continues to track the actual physical disk. 


On some systems, LSM builds a list of disk access records automatically, 
based on the list of devices attached to the system. On these systems, it is 
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not necessary to define disk access records explicitly. On other systems, 
you must define disk access records with the /sbin/voldisk define 
command. Specialty disks, such as RAM disks or floppy disks, are likely to 
require explicit /sbin/voldisk define commands. 


Disk access records are identified by their disk access names (also Known as 
DA names). 


See also disk ID, disk media record, volboot file 


disk group 

A group of disks that share a common configuration database. A 
configuration database consists of a set of records describing objects 
including disks, volumes, plexes, and subdisks that are associated with one 
particular disk group. Each disk group has an administrator-assigned name 
that you use to reference that disk group. Each disk group has an internally 
defined unique disk group 1D, which differentiates two disk groups with the 
same administrator-assigned name. 


Disk groups provide a method to partition the configuration database, so 
that the database size is not too large and so that database modifications do 
not affect too many drives. They also allow LSM to operate with groups of 
physical disk media that can be moved between systems. 


Disks and disk groups have a circular relationship: disk groups are formed 
from disks, and disk group configuration databases are stored on disks. All 
disks in a disk group are stamped with a disk group ID, which is a unique 
identifier for naming disk groups. Some or all disks in a disk group also 
store copies of the configuration database of the disk group. 


See also disk group ID, root disk group 


disk group configuration 

A small database that contains all volume, plex, subdisk, and disk media 
records. Also known as the configuration database. These databases are 
replicated onto some or all disks in the disk group, often with two copies 

on each disk. Because these databases pertain to disk groups, record 
associations cannot span disk groups. Thus, you cannot define a subdisk on a 
disk in one disk group and associate it with a volume in another disk group. 


disk group ID 

A 64-byte universally unique identifier that is assigned toa disk group 
when the disk group is created with the /sbin/voldg init command. 
This identifier is in addition to the disk group name, which you assigned. 
The disk group ID differentiates disk groups that have the same 
administrator-assigned name. 
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disk header 
A block stored in a private region of a disk that defines several properties of 
the disk, such as the: 


¢ Size of the private region 
e Location and size of the public region 
¢ Unique disk ID for the disk 


¢ Disk group !D and disk group name (if the disk is currently associated 
with a disk group) 


¢ Host 1D for a host that has exclusive use of the disk 


disk ID 

A 64-byte universally unique identifier that is assigned to a physical disk 
when its private region is initialized with the /sbin/voldisk init 
command. The disk ID is stored in the disk media record so that the physical 
disk can be related to the disk media record at system startup. 


See also disk media record 


disk media record 

A reference toa physical disk, or possibly a disk partition. This record can 
be thought of as a physical disk identifier for the disk or partition. Disk 
media records are configuration records that provide a name (known as the 
disk media name or DM name) that you use to reference a particular disk 
independent of its location on the system’s various disk controllers. Disk 
media records reference particular physical disks through a disk 1D, which 
is a unique identifier that is assigned to a disk when it is initialized for 
use with the LSM software. 


Operations are provided to set or remove the disk ID stored in a disk media 
record. Such operations have the effect of removing or replacing disks, with 
any associated subdisks being removed or replaced along with the disk. 


See also disk access record 


host ID 

A name, usually assigned by you, that identifies a particular host. Host IDs 
are used to assign ownership to particular physical disks. When a disk is 
part of a disk group that is in active use by a particular host, the disk is 
stamped with that host’s host 1D. If another host attempts to access the 
disk, it detects that the disk has a nonmatching host ID and disallows 
access until the host with ownership discontinues use of the disk. Use the 
/sbin/voldisk clearimport command to clear the host |D stored ona 
disk. 
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If a disk is a member of a disk group and has a host |D that matches a 
particular host, then that host will import the disk group as part of system 
startup. 


kernel log 

A log kept in the private region on the disk that is written by LSM kernel. 
The log contains records describing the state of volumes in the disk group. 
This log provides a mechanism for the kernel to persistently register state 
changes, so that the vold daemon can detect the state changes even in 
the event of a system failure. 


plex 

A copy of a volume'’s logical data address space; also known asa mirror. A 
volume can have up to 32 plexes associated with it. Each plex is, at least 
conceptually, a copy of the volume that is maintained consistently in the 
presence of volume 1/O and reconfigurations. Plexes represent the primary 
means of configuring storage for a volume. Plexes can have a concatenated, 
striped, or RAID 5 organization (layout). 


See also concatenated plex, RAID 5 plex, striped plex 


plex consistency 

If the plexes of a volume contain different data, then the plexes are said to be 
inconsistent. This isa problem only if LSM is unaware of the inconsistencies, 
as the volume can return differing results for consecutive reads. 


Plex inconsistency is a serious compromise of data integrity. This 
inconsistency is caused by write operations that start around the time of a 
system failure, if parts of the write complete on one plex but not the other. 
If the plexes are not first synchronized to contain the same data, plexes 
are inconsistent after creation of a mirrored volume. An important role of 
LSM is toensure that consistent data is returned to any application that 
reads a volume. This might require that plex consistency of a volume be 
“recovered” by copying data between plexes, so that they have the same 
contents. Alternatively, you can put a volume into a state such that reads 
from one plex are automatically written back to the other plexes, making the 
data consistent for that volume offset. 


private region 

Disks used by LSM contain two special regions: a private region and a 
public region. Usually, each region is formed from a complete partition of 
the disk; however, the private and public regions can be allocated from the 
same partition. 


The private region of a disk contains on-disk structures that are used by 
LSM for internal purposes. Each private region begins with a disk header 
that identifies the disk and its disk group. Private regions can also contain 
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copies of a disk group’s configuration database and copies of the disk group's 
kernel log. 


See also disk header, kernd log, public region 


public region 

The public region of a disk is the space reserved for allocating subdisks. 
Subdisks are defined with offsets that are relative to the beginning of the 
public region of a disk. Only one contiguous region of a disk can form the 
public region for a disk. 


See also private region 


RAID 5 plex 

A plex that places data and parity evenly across each of its associated 
subdisks. A plex has a characteristic number of stripe columns (represented 
by the number of associated subdisks) and a characteristic stripe width. The 
stripe width defines how much data with a particular address is allocated 
to one of the associated subdisks. The parity data is the result of an XOR 
operation on the data in each stripe unit. The parity data is written toa 
different column (presumed to be a different disk) for each stripe, left-shifted 
by one column, so that no one column contains all the parity for the volume. 
Therefore, if a disk in a RAID 5 plex fails, the volume is still recoverable by 
recreating the missing data or parity for each stripe. 


See also concatenated plex, striped plex 


read policy 

A configurable policy for switching between plexes for volume reads. When a 
volume has more than one enabled associated plex, LSM distributes reads 
between the plexes to distribute the |/O load and thus increase total possible 
bandwidth of reads through the volume. You set the read policy. Read policy 
choices include: 


* round-robin read policy 


For every other read operation, switches to a different plex from the 
one used for the previous read operation. Given three plexes, switches 
between each of the three plexes, in order. 


¢ preferred plex read policy 


Specifies a particular plex that is used to satisfy read requests. In the 
event that a read request cannot be satisfied by the preferred plex, this 
policy changes to the round-robin read policy. 


¢ select read policy 


The default policy. Adjusts to use an appropriate read policy based 
on the set of plexes associated with the volume. If only one enabled 
read-write striped plex is associated with the volume, then that plex is 
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chosen automatically as the preferred plex; otherwise, the round-robin 
policy is used. If a volume has one striped plex and one nonstriped plex, 
preferring the striped plex often yields better throughput. 


root disk group 

Each system requires one special disk group called rootdg. This group is 
generally the default for most utilities. In addition to defining the regular 
disk group information, the configuration database for the root disk group 
contains local information that is specific to a disk group. 


striped plex 

A plex that places data evenly across each of its associated subdisks. A plex 
has a characteristic number of stripe columns (represented by the number 
of associated subdisks) and a characteristic stripe width. The stripe width 
defines how much data with a particular address is allocated to one of the 
associated subdisks. Given a stripe width of 128 blocks and two stripe 
columns, the first group of 128 blocks is allocated to the first subdisk, the 
second group of 128 blocks is allocated to the second subdisk, the third group 
to the first subdisk, and so on. 


See also concatenated plex, RAID 5 plex 


subdisk 

A region of storage allocated on a disk for use by a volume. Subdisks are 
associated with volumes through plexes. You organize one or more subdisks 
to form plexes based on a plex layout: concatenated, striped or RAID 5. 
Subdisks are defined relative to disk media records. 


volboot file 

The volboot file is a special file (usually stored in /etc/vol/volboot) 
that is used to bootstrap the root disk group and to define a system's host 
1D. In addition to a host ID, the volboot file contains a list of disk access 
records. On system startup, this list of disks is scanned to find a disk that is 
a member of the rootdg disk group and that is stamped with this system's 
host 1D. When such a disk is found, its configuration database is read and 
is used to get a more complete list of disk access records that are used as a 
second-stage bootstrap of the root disk group and to locate all other disk 
groups. 


volume 

A virtual disk device that looks to applications and file systems like a 
physical disk partition device. Volumes present block and raw device 
interfaces that are compatible in their use. A volume can use mirrors, span 
several disk drives, and be moved to different disks. You can change the 
configuration of a volume without causing disruption to applications or file 
systems that are using the volume. 
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adding a data plex, 5-24 
adding a disk to a disk group, 4-3, 
5-7 
adding a log plex, 5-24 
adding a spare disk, 3-19 
AdvF S file domain 
configuring volume for, 4-15 
displaying information, 3-15 
encapsulating, 4-17 
automatic data relocation 
( Seehot-sparing feature ) 


backing up configuration database, 
5-10 
before upgrade, 3-2 

backing up volumes, 5-15 

boot disk 
creating alternate, 3-11 
encapsulating, 3-11 
mirroring, 3-11 
unencapsulating, 3-17 

boot disk failure 
recovery from, 6-23 

boot disk volume 
adding a mirror, 3-14 
converting to partitions, 3-17 
displaying information, 3-14 

bootable tape utility, 3-11n 

bootdef_dev variable, 3-12 
setting after boot disk 

unencapsulation, 3-18 


changing permissions on volumes, 
5-22 
changing the configuration database, 
5-13 
checking daemons, 6-8 
checking disk status, 6-19 
clearing lock on a volume, 6-19 
combining subdisks, 5-28 
concatenated data plex, 1-6, 1-7 
creating volume with, 4-7 
configuration database 
backing up, 5-10 
backing up before upgrade, 3-2 
changing number of copies on a 
disk, 5-13 
changing size of, 5-13 
disk requirements for, 1-5 
displaying list of backups, 5-12 
loss recovery, 6-13 
optimizing after upgrade, 3-9 
restoring from backup, 5-12 
configuring a volume for a file system, 
4-14 
configuring spare disk, 3-19 
converting boot disk volumes to 
partitions, 3-17 
creating a volume, 4-5 
for secondary swap, 4-14 
with concatenated plex, 4-7 
with RAID 5 plex, 4-12 
with striped plex, 4-8, 4-10 
creating alternate boot disk, 3-11 
creating an LSM disk 
( Seeinitializing disks ) 
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creating backup disk labels, 4-5 


D 


daemon 

checking, 6-8 

LSM, 6-7 

setting number of, 6-8 
deconfiguring spare disk, 3-19 
default volume attributes, 2-2 
deporting disk groups, 5-7 
Dirty Region Log 

(SeeDRL plex ) 
disk, 1-2, 1-3 


(SeealsoLSM disk; nopriv disk; 


simple disk; sliced disk ) 
adding to disk group, 5-7 
checking status, 6-19 
configuring spare, 3-19 
deconfiguring spare, 3-19 
displaying detailed information, 
5-2 
displaying information, 6-19 
encapsulating, 4-16 
evacuating, 5-4 
identifying unused, 2-10 
initializing for LSM, 5-1 
LSM, 1-2 
nopriv, 1-4 
placing off line, 5-3 
placing on line, 5-4 
recovering, 6-19 


recovering from temporary failure, 


6-20 
removing from disk group, 5-9 
removing from LSM, 5-4 
renaming, 5-3 
replacing failed, 6-21 
replacing failing, 6-21 
simple, 1-4 
sliced, 1-3 
spare, 3-19 
disk access name, 1-5 
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disk group 


about, 1-5 

adding a disk, 4-3, 5-7 
creating, 4-3, 5-6 

deporting, 5-7 

displaying available space in, 4-2 
displaying free space in, 5-6 
displaying information, 4-1, 5-5 
importing, 5-8 

importing failure, 6-24 
managing, 5-5 

maximum volume size, 5-6 
moving to another system, 5-8 
planning worksheet, 2-9 
recovering, 6-19 

removing disks, 5-9 


disk label 


creating backup, 4-5 


disk media name, 1-5 
displaying information 


AdvFS file domain, 3-15 

available space in disk group, 4-2 

boot disk volume, 3-14 

configuration database backups, 
5-12 

daemons, 6-8 

default volume attributes, 4-5 

disk, 5-2, 6-19 

disk group, 5-5 

free space in disk group, 5-5 

free space in disk groups, 5-6 

I/O statistics, 6-2 

list of disks, 5-5 

LSM events, 6-1 

LSM object states, 6-3 

maximum volume size, 5-6 

plex, 5-22 

subdisks, 5-27 

swap space volume, 3-16 

UFS file system, 3-16 

volume, 5-14 

volume conditions, 6-10 


volume resynchronization status, 


6-18 

dissociating objects 

plex, 5-26 

subdisks, 5-29 
dividing a subdisk 

( Seesplitting a subdisk ) 
DRL plex, 1-7 
dxlsm 

(See LSM interfaces ) 


E 


unencapsulating, 5-20 
files 
changed after boot disk 
encapsulation, 3-12 
free space in disk group 
displaying, 4-2 
fstab file, 3-12, 3-17 


H 


enabling the hot-sparing feature, 
3-18 


encapsulating AdvF S file domains, 


4-17 
encapsulating disks, 4-16 
encapsulating disks or partitions, 
4-16 
encapsulating partitions, 4-16 
encapsulating the boot disk, 3-11 
files changed by, 3-12 
error messages, 7-1 
kernel, 7-16 
vold daemon, 7-1 
/etc/default/volassist file, 4-6 
/etc/fdmns directory, 3-17 
/etc/fdmns/ directory, 3-12 
/etc/fstab file, 3-12, 3-17 
/etc/sysconfigtab file, 3-12, 3-17, 
6-7 
evacuating disk, 5-4 
event monitoring, 6-1 


F 


hot-sparing feature 
enabling, 3-18 
moving objects relocated by, 3-23 


fdmns directory, 3-12, 3-17 
file system 
configuring volumes for, 4-14 
troubleshooting, 6-10 


I/O statistics 
displaying, 6-2 
identifying unused disks, 2-10 
with disk configuration GUI, 2-11 
with operating system commands, 
2-12 
with voldisk command, 2-12 
importing disk groups, 5-8 
initializing disks, 5-1 
initializing LSM, 3-4 
installing LSM, 3-1, 3-3 
installing Storage Administrator, A-2 
installing the LSM license, 3-4 


J 


joining subdisks, 5-28 


K 


kernel states, 6-4 


L 


log plex 
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adding, 5-24 
LSM 
verifying initialization, 3-6 
LSM commands, 1-15 
LSM daemon 
monitoring, 6-7 
LSM events 
displaying information about, 6-1 
monitoring, 6-1 
LSM files, 3-7 
LSM interfaces, 1-14 
command line, 1-15 
Storage Administrator 
customizing, B-1 
using, A-1 
Visual Administrator (dxlsm), D-1 
voldiskadm menu, C-1 
LSM license 
installing, 3-4 
LSM object 
monitoring states, 6-3 
LSM software subset, 3-3 
LSM states, 6-4 


moving data to new plex, 5-24 
moving objects 
disk group, to another system, 5-8 
relocated by hot-sparing, 3-23 
subdisks, 5-29 


N 


nopriv disk, 1-4 
configuration database and, 1-5 


P 


mail notification 

enabling, 3-19 

examples, 3-19 

setting up, 3-19 
managing LSM objects, 5-1 

disk groups, 5-5 

disks, 5-1 

plexes, 5-22 

subdisks, 5-27 

volumes, 5-14 
maximum volume size 

displaying, 5-6 
mirror plex, 1-8, 1-11 
mirroring the boot disk volume, 3-14 
monitoring daemons, 6-7 
monitoring I/O statistics, 6-2 
monitoring LSM events, 6-1 
monitoring LSM object states, 6-3 
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partition 
encapsulating, 4-16 
permission attributes 
changing, 5-22 
placing disk offline, 5-3 
placing disk online, 5-4 
planning disk groups, 2-7 
planning volumes, 2-1 
plex 
adding, data, 5-24 
adding, log, 5-24 
concatenated, 1-7 
displaying information, 5-22 
dissociating, 5-26 
mirror, 1-8, 1-11 
moving data, 5-24 
RAID 5, 1-12 
reattaching, 5-26 
removing, 5-26 
striped, 1-9 
plex states, 6-5 
plex types, 1-6 
concatenated, 1-6 
DRL, 1-7 
RAID 5, 1-7 
RAID 5 log, 1-7 
striped, 1-7 
postinstallation tasks, 3-4 
encapsulating the boot disk, 3-11 


optimizing configuration database, 


preinstallation tasks, 3-1 
providing boot disk redundancy, 3-11 


R 


S 


RAID 5 data plex, 1-7 
RAID 5 log plex, 1-7 
RAID 5 plex, 1-12 
creating a volume with, 4-12 
reattaching a plex, 5-26 
recovering from temporary disk 
failure, 6-20 
recovering objects 
failed boot disk, 6-23 
mirror plex, 6-12 
RAID 5 log plex, 6-16 
RAID 5 plex, 6-14 
stale subdisks, 6-20 
volumes, 5-21 
recovering stale subdisks, 6-20 
recovering unstartable volumes, 6-10 
removing disks 
from a disk group, 5-9 
from LSM, 5-4 
removing LSM objects 
plex, 5-26 
subdisks, 5-29 
volumes, 5-20 
removing LSM software, 6-25 
removing spare disk, 3-19 
renaming disks, 5-3 
renaming volumes, 5-22 
replacing a disk 
failed, 6-21 
failing, 6-21 
restoring configuration database 
from backup, 5-12 
restoring volumes from backup, 5-18 
rootdg disk group 
planning worksheet, 2-8 


setting daemons, 6-8 
setting up mail notification, 3-19 
simple disk, 1-4 
sliced disk, 1-3 
software subset 
LSM, 3-3 
spare disk 
adding, 3-19 
configuring, 3-19 
deconfiguring, 3-19 
splitting a subdisk, 5-28 
starting Storage Administrator, A-2 
starting volumes, 5-19, 6-10 
stopping volumes, 5-19 
Storage Administrator, A-1 
access log file, B-2 
adding disk, A-6 
adding disk toa disk group, A- 14 
adding file system, A-28 
adding log, A-30 
adding mirror, A-31 
Alert Monitor window, B-12 
analyzing activity, A-26 
checking file system, A- 34 
dearing alerts, B-15 
dosing, A-6 
command log file, B-1 
copying volume data, A- 35 
creating disk group, A-15 
creating volume, A-35 
deporting disk group, A- 16 
destroying disk group, A- 18 
disabling mirror, A- 32 
docking the Command Launcher, 
B-16 
docking the toolbar, B-16 
evacuating disk, A-8 
exiting, A-6 
importing disk group, A-17 
installing, A-2 
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joining subdisks, A-21 

keyboard shortcuts, B-15 

main window, A-3, B-4 
managing disk groups, A- 14 
managing disks, A-6 

managing subdisks, A-21 
managing volumes, A-25 
mirroring disk, A-9 

mounting file system, A-37 
moving disk group, A- 19 
moving subdisk, A-22 

Object Properties dialog box, B-6 
Object Table Copy window, B-13 
overview, A-1 

placing disk off line, A-14 
placing disk on line, A- 10 
pop-up menus, A-5 

recovering volumes, A- 39 


recovering volumes in a disk group, 


A-20 


recovering volumes on a disk, A-11 


removing disk from disk group, 
A-11 

removing log, A-40 

removing mirror, A-41 

removing subdisk, A-24 

removing volume, A- 40 

renaming disk, A-12 

renaming disk group, A- 20 

renaming volume, A- 41 

repairing mirror, A-33 

replacing disk, A-13 

resizing volume, A-42 

restoring volume from backup, 
A-38 

right mouse button, A-5 

scanning for new disks, A- 14 

Search window, B-13 

selecting objects, A-5 

server log file, B-2 

shortcuts, B-15 

sorting objects, B- 15 
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specifying object sizes, B-4 

specifying objects, B-3 

splitting subdisk, A-24 

starting, A-2 

starting volume, A-43 

stopping volume, A-44 

Task Request Monitor window, 
B-14 

tracking activity, B-1 

unmounting file system, A-44 

User Preferences dialog box, B-7 

using Command Launcher, A-6 

using dialog boxes, B-3 

using menu bar, A-5 

viewing objects, B-4 

Volume Layout Details window, 
B-5 

striped plex, 1-7, 1-9 


creating a volume with, 4-8, 4-10 


subdisk states, 6-7 
subdisks 
combining, 5-28 
defined, 1-5 
displaying information, 5-27 
dissociating, 5-29 
joining, 5-28 
moving data in, 5-29 
removing, 5-29 
splitting, 5-28 
swap space volume 
displaying information, 3-16 
sysconfigtab file, 3-12, 3-17 
troubleshooting, 6-7 


T 


troubleshooting 
LSM, 6-1 
nonredundant volumes, 6-10 
startup problems, 6-7 
sysconfigtab file, 6-7 
unstartable volumes, 6-10, 6-12 


U 


UFS file system 
configuring volume for, 4-15 
displaying information, 3-16 
unencapsulating file system, 5-20 
unencapsulating the boot disk, 3-17 
files changed by, 3-17 
uninstalling LSM, 6-25 
upgrading LSM, 3-1 


V 


verifying LSM initialization, 3-6 
Visual Administrator 
analysis, E-42 
analysis forms, E-43 
analysis menus, E-43 
analysis table, E-45 
default views, D-2 
disk forms, E-30 
disk group forms, E- 39 
disk group management, E-36 
disk group menus, E-36 
disk management, E-27 
disk menus, E-27 
error messages, D-7 
file system forms, E-48 
file system menus, E-46 
forms, D-7 
help, D-7 
main window, D-1 
object icons, D-4 
plex forms, E-18 
plex management, E- 16 
plex menus, E-16 
project menu, E-41 
projection analysis, E-40 
projection relationships, E-42 
pull-down menus, D-6 
starting, D-1 
subdisk forms, E-23 


subdisk management, E-21 
subdisk menus, E-21 
UFS management, E-45 
user-created views, D-2 
using mouse buttons, D-3 
View of rootdg window, D-2 
volume forms, E-8 
volume management, E-1 
volume menus, E-1 
volassist command, 4-5 
vold daemon 
monitoring, 6-7 
voldg command, 5-6, 5-7 
voldisk command, 5-2, 5-4, 5-5 
voldiskadd script, 4-3 
voldiskadm menu 
adding disk to disk group, C-5 
deporting disk group, C-13 
disabling disk, C-11 
displaying disk information, C-4 
exiting, C-15 
importing disk group, C-12 
initializing disk, C-2 
managing disk groups, C- 12 
managing disks, C-2 
managing volumes, C- 14 
moving data off disk, C-7 


removing disk from disk group, C-8 


replacing disk, C- 10 
voldiskadm menu interface, C-1 

starting, C-1 
voldisksetup command, 5-1 
volevac command, 5-4 
voliod daemon 

monitoring, 6-7 
volmend command, 6-12 
volrecover command, 5-21 
volrestore command, 5-18 
volstat command, 6-2 
volume 

backing up, 5-15 

changing permissions, 5-22 
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clearing lock, 6-19 

common attributes, 4-6 

creating, 4-5 

defined, 1-13 

displaying conditions of, 6-10 
displaying information, 5-14 
displaying maximum size, 5-6 
example default attributes file, 4-6 
for secondary swap space, 4-14 
insufficient space to create, 6-9 
planning worksheet, 2-4, 2-5 
reattaching a plex, 5-26 
recovering, 5-21, 6-8 

recovering a mirror plex, 6-12 
recovering a RAID 5 plex, 6-14 
recovering disabled volume, 6-10 
recovering nonredundant, 6-10 
recovering startable, 6-10 
recovering unstartable, 6-10, 6-12 
removing, 5-20 

renaming, 5-22 

restoring from backup, 5-18 
starting, 5-19 
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stopping, 5-19 
volume attributes 
default, 2-2 
displaying default, 4-5 
volume kernel states, 6-4 
volume recovery 
loss of configuration database, 6-13 
mirror plexes, 6-12 
nonredundant, 6-10 
RAID 5 log plex, 6-16 
stale subdisks, 6-20 
volume resynchronization 
checking status of, 6-18 
volume states, 6-5 


W 


worksheet for planning volumes 
with concatenated plex, 2-4 
with RAID 5 plex, 2-6 
with striped plex, 2-5 
worksheets for planning disk groups, 
2-7 
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UNIX Documentation Overview, which describes the structure and organization of 
the Tru64 UNIX documentation and provides brief overviews of each document. 


The following table provides the order numbers for the Tru64 UNIX operating system 
documentation kits. For additional information about ordering this and related 
documentation, see the Documentation Overview or contact Compaq. 


Name Order Number 
Tru64 UNIX Documentation CD-ROM QA-6ADAA-G8 
Tru64 UNIX Documentation Kit QA-6ADAA-GZ 
End User Documentation Kit QA-6ADAB-GZ 
Startup Documentation Kit QA-6ADAC-GZ 
General User Documentation Kit QA-6ADAD-GZ 
System and Network Management Documentation Kit QA-6ADAE-GZ 
Developer’s Documentation Kit QA-6ADAF -GZ 
Reference Pages Documentation Kit QA-6ADAG-GZ 


TruCluster Server Documentation Kit QA-6BRAA-GZ 


Reader’s Comments 


Tru64 UNIX 
Logical Storage Manager 
AA-RH9BB-TE 


Compaq welcomes your comments and suggestions on this manual. Your input will help us to write 
documentation that meets your needs. Please send your suggestions using one of the following methods: 


e This postage-paid form 
¢ — Internet electronic mail: readers_comment@zk3 .dec.com 
* Fax: (603) 884-0120, Attn: UBPG Publications, ZK 03-3/Y 32 


If you are not using this form, please be sure you include the name of the document, the page number, and 
the product name and version. 


Please rate this manual: 


Excellent Good Fair Poor 


Accuracy (software works as manual says) 
Clarity (easy to understand) 

Organization (structure of subject matter) 
Figures (useful) 

Examples (useful) 

Index (ability to find topic) 

Usability (ability to access information quickly) 


Please list errors you have found in this manual: 


Page Description 


Additional comments or suggestions to improve this manual: 


What version of the software described by this manual are you using? 


Name, title, department 
Mailing address 
Electronic mail 
Telephone 

Date 
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